Start a durable asynchronous tool call
Start one durable asynchronous tool call.
Authentication
AuthorizationBearer
Use Bearer <api-key>.
Path parameters
toolRef
Headers
BCTRL-Subaccount-Id
Optional effective subaccount context for organization API keys. Subaccount API keys are already scoped and cannot use this header to act as another subaccount.
BCTRL-Runtime-Id
Optional Runtime selector for direct Runtime-bound Tool calls. The Control Plane resolves the active Run atomically; callers cannot select a Run directly.
Idempotency-Key
Optional retry key for this billable operation. Reusing the same key with the same request replays its stable outcome; credential-bearing results may be freshly issued for the same principal. Reusing it with a different request returns 409.
Request
This endpoint expects an object.
Response
Accepted
OR
OR
OR
OR
OR
OR
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error