Command reference
deployments model-credential
The organization's own model provider keys
| Command | Summary |
|---|---|
deployments model-credential list | List the organization's model provider keys; keys are shown by last four only |
deployments model-credential show | Show one model provider key without revealing it |
deployments model-credential set | Verify a provider key with the provider, then store or replace it |
deployments model-credential remove | Remove a model provider key; its metadata stays for audit |
deployments model-credential list
List the organization's model provider keys; keys are shown by last four only.
deployments model-credential list <organization-id>- Calls
GET /v1/organizations/{id}/model-credentials(SDKlistModelCredentials). - Needs an organization:
--orgor 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 | ||
<organization-id> | positional | yes | Organization ID |
Also accepts the global flags.
deployments model-credential show
Show one model provider key without revealing it.
deployments model-credential show <organization-id> <provider>- Calls
GET /v1/organizations/{id}/model-credentials/{provider}(SDKgetModelCredential). - Needs an organization:
--orgor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<organization-id> | positional | yes | Organization ID | |
<provider> | positional | yes | Model provider: openai or openrouter |
Also accepts the global flags.
deployments model-credential set
Verify a provider key with the provider, then store or replace it.
deployments model-credential set <organization-id> <provider>- Calls
PUT /v1/organizations/{id}/model-credentials/{provider}(SDKputModelCredential). - Needs an organization:
--orgor the saved context. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--api-key | string | Provider API key (prefer env or file source) | ||
<organization-id> | positional | yes | Organization ID | |
<provider> | positional | yes | Model provider: openai or openrouter | |
--label | string | Label shown with the key | ||
--api-key-env | string | Environment variable containing the provider API key | ||
--api-key-file | string | File containing the provider API key |
Also accepts the global flags.
deployments model-credential remove
Remove a model provider key; its metadata stays for audit.
deployments model-credential remove <organization-id> <provider>- Calls
DELETE /v1/organizations/{id}/model-credentials/{provider}(SDKdeleteModelCredential). - Needs an organization:
--orgor 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 |
|---|---|---|---|---|
<organization-id> | positional | yes | Organization ID | |
<provider> | positional | yes | Model provider: openai or openrouter |
Also accepts the global flags.