Command reference
deployments model-policy
Environment model admission policy
| Command | Summary |
|---|---|
deployments model-policy create | Create the environment model policy |
deployments model-policy list | List model policies |
deployments model-policy show | Show a model policy |
deployments model-policy update | Update a model policy |
deployments model-policy archive | Archive a model policy |
deployments model-policy create
Create the environment model policy.
deployments model-policy create --name <name> --include-curated-models- Calls
POST /v1/model-policies(SDKcreateModelPolicy). - Needs an environment:
--envor the saved context. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--name | string | yes | Resource name | |
--description | string | Resource description | ||
--include-curated-models | boolean | yes | Keep the platform's curated models allowed; pass --no-include-curated-models to allow only the listed models | |
--model | string | Allowed canonical model id or provider-wide entry such as openrouter/* (repeatable) | ||
--models | string (json) | Allowed model entries as a JSON array |
Also accepts the global flags.
deployments model-policy list
List model policies.
deployments model-policy list- Calls
GET /v1/model-policies(SDKlistModelPolicies). - Needs an environment:
--envor the saved context. - Paginated.
--page-sizesets the page size; pass the returned cursor as--cursorfor the next page.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--cursor | string (cursor) | Pagination cursor | ||
--page-size | string (number) | Page size |
Also accepts the global flags.
deployments model-policy show
Show a model policy.
deployments model-policy show <id>- Calls
GET /v1/model-policies/{id}(SDKgetModelPolicy). - Needs an environment:
--envor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments model-policy update
Update a model policy.
deployments model-policy update <id> --expected-version <number>- Calls
PATCH /v1/model-policies/{id}(SDKupdateModelPolicy). - Needs an environment:
--envor the saved context. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--name | string | Resource name | ||
--description | string | Resource description | ||
--include-curated-models | boolean | Keep the platform's curated models allowed; pass --no-include-curated-models to allow only the listed models | ||
--model | string | Allowed canonical model id or provider-wide entry such as openrouter/* (repeatable) | ||
--models | string (json) | Allowed model entries as a JSON array | ||
--expected-version | string (number) | yes | Expected model policy version |
Also accepts the global flags.
deployments model-policy archive
Archive a model policy.
deployments model-policy archive <id> --expected-version <number>- Calls
DELETE /v1/model-policies/{id}(SDKarchiveModelPolicy). - Needs an environment:
--envor the saved context. - Destructive. Live runs ask for confirmation; pass
--yesin scripts or with--json. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--expected-version | string (number) | yes | Expected model policy version |
Also accepts the global flags.