Deployments.ai Docs
Command reference

deployments tool-call

Tool calls and asynchronous results

CommandSummary
deployments tool-call listList tool calls for a run (client tools show executionType, input, expiresAt)
deployments tool-call resultSubmit 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 (SDK listRunToolCalls).
  • Needs an environment: --env 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
--runstringyesRun 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>
FlagTypeRequiredDefaultDescription
<id>positionalyesResource ID
--runstringyesRun ID
--threadstringyesThread ID
--external-operation-idstringExternal operation ID (required for provider-asynchronous tools)
--outcomestringyescompleted or failed
--outputstring (json)Structured output JSON object (client tools)
--output-filestringPath to a structured output JSON file
--output-summarystringSafe output summary

Also accepts the global flags.

On this page