API Referencetools

Call a synchronous tool and wait for its result

View as Markdown
Call a synchronous tool and wait for its validated result.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

toolRefstringRequired

Headers

BCTRL-Subaccount-IdstringOptional
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-IdstringOptional

Optional Runtime selector for direct Runtime-bound Tool calls. The Control Plane resolves the active Run atomically; callers cannot select a Run directly.

Request

This endpoint expects an object.

Response

OK

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