Command reference
deployments connection
Provider connections and verification
| Command | Summary |
|---|---|
deployments connection authorize | Start provider authorization |
deployments connection list | List provider connections |
deployments connection show | Show a provider connection |
deployments connection verify | Verify a provider connection |
deployments connection revoke | Revoke a provider connection |
deployments connection tools-sync | Sync vendor MCP tools for a provider connection |
deployments connection authorize
Start provider authorization.
deployments connection authorize --provider <provider>- Calls
POST /v1/connections(SDKbeginProviderAuthorization). - 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 |
|---|---|---|---|---|
--provider | string | yes | Provider key | |
--oauth-app | string | OAuth application registration ID | ||
--resource | string | Provider account or external resource to authorize | ||
--return-url | string | https URL on an allowlisted return origin (PLATFORM_OAUTH_RETURN_ORIGINS); the callback redirects there with connection_id and provider, or error |
Also accepts the global flags.
deployments connection list
List provider connections.
deployments connection list- Calls
GET /v1/connections(SDKlistProviderConnections). - 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 connection show
Show a provider connection.
deployments connection show <id>- Calls
GET /v1/connections/{id}(SDKgetProviderConnection). - Needs an environment:
--envor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments connection verify
Verify a provider connection.
deployments connection verify <id>- Calls
POST /v1/connections/{id}/verify(SDKrequestConnectionVerification). - 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 |
Also accepts the global flags.
deployments connection revoke
Revoke a provider connection.
deployments connection revoke <id>- Calls
DELETE /v1/connections/{id}(SDKrevokeProviderConnection). - 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.
deployments connection tools-sync
Sync vendor MCP tools for a provider connection.
deployments connection tools-sync <id>- Calls
POST /v1/connections/{connectionId}/tools/sync(SDKsyncConnectionTools). - 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 |
Also accepts the global flags.