Create a tool

View as Markdown
Create an organization custom callable tool. Agents can use these tools through space toolsets during hosted work.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

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.

Request

This endpoint expects any.
anyRequired
OR
anyRequired
OR
anyRequired

Response

Created
BuiltinToolobject
OR
CustomToolobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error