Command reference
deployments oauth-app
Subscriber-owned OAuth applications
| Command | Summary |
|---|---|
deployments oauth-app register | Register an OAuth application |
deployments oauth-app list | List OAuth applications |
deployments oauth-app show | Show an OAuth application |
deployments oauth-app rotate | Rotate an OAuth client secret |
deployments oauth-app archive | Archive an OAuth application |
deployments oauth-app register
Register an OAuth application.
deployments oauth-app register --name <name> --provider <provider> --client-id <client-id> --scopes <a-b-c> --redirect-uri <a-b-c>- Calls
POST /v1/oauth-apps(SDKcreateProviderApplication). - Needs an environment:
--envor the saved context. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely. - Output contains secrets. They are redacted unless you pass
--reveal.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--name | string | yes | Resource name | |
--provider | string | yes | Provider key | |
--client-id | string | yes | OAuth client ID | |
--client-secret | string | OAuth client secret (prefer env or file source) | ||
--client-secret-env | string | Environment variable containing the client secret | ||
--client-secret-file | string | File containing the client secret | ||
--credential | string | Provider-specific OAuth credential JSON (prefer env or file source) | ||
--credential-env | string | Environment variable containing provider-specific OAuth credential JSON | ||
--credential-file | string | File containing provider-specific OAuth credential JSON | ||
--registration | string (json) | Vendor MCP pre-registration, e.g. {"method":"pre_registered","tokenEndpointAuthMethod":"none"} | ||
--scopes | string (a,b,c) | yes | Provider scopes | |
--redirect-uri | string (a,b,c) | yes | Configured callback URLs |
Also accepts the global flags.
deployments oauth-app list
List OAuth applications.
deployments oauth-app list- Calls
GET /v1/oauth-apps(SDKlistProviderApplications). - 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 oauth-app show
Show an OAuth application.
deployments oauth-app show <id>- Calls
GET /v1/oauth-apps/{id}(SDKgetProviderApplication). - Needs an environment:
--envor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments oauth-app rotate
Rotate an OAuth client secret.
deployments oauth-app rotate <id> --expected-version <number>- Calls
POST /v1/oauth-apps/{id}/rotate(SDKrotateProviderApplicationSecret). - 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. - Output contains secrets. They are redacted unless you pass
--reveal.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--expected-version | string (number) | yes | Expected resource version | |
--client-secret | string | New OAuth client secret (prefer env or file source) | ||
--client-secret-env | string | Environment variable containing the new client secret | ||
--client-secret-file | string | File containing the new client secret | ||
--credential | string | Replacement provider-specific OAuth credential JSON (prefer env or file source) | ||
--credential-env | string | Environment variable containing replacement OAuth credential JSON | ||
--credential-file | string | File containing replacement OAuth credential JSON |
Also accepts the global flags.
deployments oauth-app archive
Archive an OAuth application.
deployments oauth-app archive <id>- Calls
DELETE /v1/oauth-apps/{id}(SDKarchiveProviderApplication). - 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 | |
--reason | string | Reason for this operation |
Also accepts the global flags.