Command reference
deployments approval
Human approval decisions
| Command | Summary |
|---|---|
deployments approval list | List approval requests |
deployments approval show | Show an approval request |
deployments approval approve | Approve a pending tool call |
deployments approval reject | Reject a pending tool call |
deployments approval list
List approval requests.
deployments approval list- Calls
GET /v1/approvals(SDKlistApprovals). - 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 | ||
--status | string | Approval status |
Also accepts the global flags.
deployments approval show
Show an approval request.
deployments approval show <id> --run <run>- Calls
GET /v1/runs/{runId}/approvals/{approvalId}(SDKgetApproval). - Needs an environment:
--envor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--run | string | yes | Run ID |
Also accepts the global flags.
deployments approval approve
Approve a pending tool call.
deployments approval approve <id> --run <run> --thread <thread>- Calls
POST /v1/runs/{runId}/approvals/{approvalId}/resolve(SDKresolveApproval). - Needs an environment:
--envor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--run | string | yes | Run ID | |
--thread | string | yes | Thread ID |
Also accepts the global flags.
deployments approval reject
Reject a pending tool call.
deployments approval reject <id> --run <run> --thread <thread>- Calls
POST /v1/runs/{runId}/approvals/{approvalId}/resolve(SDKresolveApproval). - Needs an environment:
--envor the saved context. - Destructive. Live runs ask for confirmation; pass
--yesin scripts or with--json.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--run | string | yes | Run ID | |
--thread | string | yes | Thread ID |
Also accepts the global flags.