Update Tool | BCTRL Docs

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

AuthorizationBearer

Use Bearer <api-key>.

idstringRequired

This endpoint expects an object.

authSecretIdstring or nullOptional1-200 characters

descriptionstring or nullOptional<=2000 characters

inputSchemaobjectOptional

metadataobject or nullOptional

namestringOptionalformat: "^[a-z_][a-z0-9_-]*$"1-64 characters

outputSchemaobjectOptional

statusenumOptional

timeoutMsintegerOptional<=120000

builtinobject

hostedobject

mcpobject

webhookobject

workflowobject

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

$	curl -X PATCH https://api.bctrl.ai/v1/tools/id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"type": "webhook",
3	"createdAt": "2024-05-20T10:15:30Z",
4	"description": "Webhook tool for processing user data submissions.",
5	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
6	"inputSchema": {},
7	"name": "user_data_processor",
8	"outputSchema": {},
9	"spaceId": "7e9a1f2b-4c3d-4e5f-8a9b-0c1d2e3f4a5b",
10	"status": "enabled",
11	"updatedAt": "2024-06-01T12:00:00Z",
12	"url": "https://hooks.example.com/process-user-data",
13	"authSecretId": "authsec_9f8b7c6d5e4a3b2c1d0e",
14	"metadata": {},
15	"timeoutMs": 30000
16	}