Skip to navigation
Command reference

tool-calls Commands

View as Markdown

Manage tool-calls

Output formatting flags (--json, --jq, and --template) are documented once in Output Formatting and are omitted from the tables below.

bctrl tool-calls cancel

Cancel one active cancellable tool call.

bctrl tool-calls cancel <toolCallId> [flags]
FlagDescription
--headers <json>API headers: inline JSON, @file, or - for stdin
--api-version <date>Dated API contract (default: 2026-10-03)
--space <id-or-name>Select an authorized Space (BCTRL-Space)
--subaccount-id <id>Effective subaccount context (BCTRL-Subaccount-Id)
--idempotency-key <key>Retry key for this operation

bctrl tool-calls get

Get one tool call audit record by the same tool call id that appears in webhook payloads and run events.

bctrl tool-calls get <toolCallId> [flags]
FlagDescription
--query <json>Query object: inline JSON, @file, or - for stdin
--params <json>Alias for —query
--wait <value>Query parameter wait
--headers <json>API headers: inline JSON, @file, or - for stdin
--api-version <date>Dated API contract (default: 2026-10-03)
--space <id-or-name>Select an authorized Space (BCTRL-Space)
--subaccount-id <id>Effective subaccount context (BCTRL-Subaccount-Id)

bctrl tool-calls list

List durable tool execution lifecycle and audit records.

bctrl tool-calls list [flags]
FlagDescription
--query <json>Query object: inline JSON, @file, or - for stdin
--params <json>Alias for —query
--runtime-id <value>Query parameter runtimeId
--run-id <value>Query parameter runId
--task-id <value>Query parameter taskId
--tool <value>Query parameter tool
--status <value>Query parameter status
--cursor <value>Query parameter cursor
--order <value>Query parameter order
--limit <value>Query parameter limit
--space-id <value>Query parameter spaceId
--headers <json>API headers: inline JSON, @file, or - for stdin
--api-version <date>Dated API contract (default: 2026-10-03)
--space <id-or-name>Select an authorized Space (BCTRL-Space)
--subaccount-id <id>Effective subaccount context (BCTRL-Subaccount-Id)

bctrl tool-calls respond

Provide bounded input requested by a suspended tool call.

bctrl tool-calls respond <toolCallId> [flags]
FlagDescription
--headers <json>API headers: inline JSON, @file, or - for stdin
--api-version <date>Dated API contract (default: 2026-10-03)
--space <id-or-name>Select an authorized Space (BCTRL-Space)
--subaccount-id <id>Effective subaccount context (BCTRL-Subaccount-Id)
--idempotency-key <key>Retry key for this operation
--body <json>Request body: inline JSON, @file, or - for stdin

bctrl tool-calls result

Retrieve the result for an authorized tool call; a pending call returns its current state so callers can poll again.

bctrl tool-calls result <toolCallId> [flags]
FlagDescription
--query <json>Query object: inline JSON, @file, or - for stdin
--params <json>Alias for —query
--wait <value>Query parameter wait
--headers <json>API headers: inline JSON, @file, or - for stdin
--api-version <date>Dated API contract (default: 2026-10-03)
--space <id-or-name>Select an authorized Space (BCTRL-Space)
--subaccount-id <id>Effective subaccount context (BCTRL-Subaccount-Id)