Deployments.ai Docs
Command reference

deployments model-credential

The organization's own model provider keys

CommandSummary
deployments model-credential listList the organization's model provider keys; keys are shown by last four only
deployments model-credential showShow one model provider key without revealing it
deployments model-credential setVerify a provider key with the provider, then store or replace it
deployments model-credential removeRemove 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 (SDK listModelCredentials).
  • Needs an organization: --org or the saved context.
  • Paginated. --page-size sets the page size; pass the returned cursor as --cursor for the next page.
FlagTypeRequiredDefaultDescription
--cursorstring (cursor)Pagination cursor
--page-sizestring (number)Page size
<organization-id>positionalyesOrganization 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>
FlagTypeRequiredDefaultDescription
<organization-id>positionalyesOrganization ID
<provider>positionalyesModel 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>
FlagTypeRequiredDefaultDescription
--api-keystringProvider API key (prefer env or file source)
<organization-id>positionalyesOrganization ID
<provider>positionalyesModel provider: openai or openrouter
--labelstringLabel shown with the key
--api-key-envstringEnvironment variable containing the provider API key
--api-key-filestringFile 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} (SDK deleteModelCredential).
  • Needs an organization: --org or the saved context.
  • Destructive. Live runs ask for confirmation; pass --yes in scripts or with --json.
  • Sends an idempotency key. The CLI generates one per run; pass --idempotency-key to retry safely.
FlagTypeRequiredDefaultDescription
<organization-id>positionalyesOrganization ID
<provider>positionalyesModel provider: openai or openrouter

Also accepts the global flags.

On this page