API Referencetools

Delete a tool

View as Markdown
Delete an organization custom tool. This removes the definition, not historical tool call records.

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.

Response

OK
deletedtrue
idstring
Unique tool identifier generated by BCTRL.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error