Respond to a tool call that requires input

Provide bounded input requested by a suspended tool call.

AuthorizationBearer

Use Bearer <api-key>.

toolCallIdstringRequired

Unique toolCall identifier generated by BCTRL.

This endpoint expects any.

any

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

1	{
2	"callerType": "api",
3	"createdAt": "2026-07-26T12:00:00Z",
4	"error": null,
5	"finishedAt": null,
6	"id": "tc_AAAAAAAAAAAAAAAAAAAAAA",
7	"inputRequest": null,
8	"parentId": "tc_AAAAAAAAAAAAAAAAAAAAAA",
9	"resultAvailable": false,
10	"runId": "run_AAAAAAAAAAAAAAAAAAAAAA",
11	"runtimeId": "rt_AAAAAAAAAAAAAAAAAAAAAA",
12	"spanId": "span_AAAAAAAAAAAAAAAAAAAAAA",
13	"startedAt": "2026-07-26T12:00:00Z",
14	"status": "string",
15	"tool": "stagehand.act",
16	"turnId": "turn_AAAAAAAAAAAAAAAAAAAAAA"
17	}

$	curl -X POST https://api.bctrl.ai/v1/tool-calls/toolCallId/respond \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"