API Referencetools

Update a tool

View as Markdown
Update a custom tool definition. Changes apply to future tool use while existing tool call records remain available.

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.

Request

This endpoint expects an object.
currentRevisionIdstringRequired
Unique toolRevision identifier generated by BCTRL.
descriptionstringOptional<=2000 characters
implementationobjectOptional
inputSchemaobjectOptional
modeslist of enumsOptional
outputSchemaobjectOptional
runtimeTypeslist of enumsOptional

Response

OK
BuiltinToolobject
OR
CustomToolobject

Errors

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