Command reference
deployments tool-call
Tool calls and asynchronous results
| Command | Summary |
|---|---|
deployments tool-call list | List tool calls for a run (client tools show executionType, input, expiresAt) |
deployments tool-call result | Submit an asynchronous or client-executed tool result |
deployments tool-call list
List tool calls for a run (client tools show executionType, input, expiresAt).
deployments tool-call list --run <run>- Calls
GET /v1/runs/{runId}/tool-calls(SDKlistRunToolCalls). - 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 | ||
--run | string | yes | Run ID |
Also accepts the global flags.
deployments tool-call result
Submit an asynchronous or client-executed tool result.
deployments tool-call result <id> --run <run> --thread <thread> --outcome <outcome>- Calls
POST /v1/runs/{runId}/tool-calls/{toolCallId}/results(SDKresolveToolResult). - 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 | |
--external-operation-id | string | External operation ID (required for provider-asynchronous tools) | ||
--outcome | string | yes | completed or failed | |
--output | string (json) | Structured output JSON object (client tools) | ||
--output-file | string | Path to a structured output JSON file | ||
--output-summary | string | Safe output summary |
Also accepts the global flags.