Get Toolset | BCTRL Docs

Get one toolset, including its built-in capabilities, custom tool IDs, and metadata. Use this to confirm exactly which tools an invocation will expose.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

toolsetIdstringRequired

Response

Default Response

builtinobject

createdAtstring

customToolIdslist of strings

idstringformat: "uuid"

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

spaceIdstringformat: "uuid"

updatedAtstring

metadatamap from strings to any or null

1	{
2	"builtin": {
3	"artifacts": true,
4	"captcha": true,
5	"storage": true,
6	"vault": true
7	},
8	"createdAt": "2024-05-20T10:15:30Z",
9	"customToolIds": [
10	"3fa85f64-5717-4562-b3fc-2c963f66afa6",
11	"7c9e6679-7425-40de-944b-e07fc1f90ae7"
12	],
13	"id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
14	"name": "data_tools",
15	"spaceId": "9f8e7d6c-5b4a-3f2e-1d0c-9b8a7f6e5d4c",
16	"updatedAt": "2024-06-01T08:45:00Z",
17	"metadata": {
18	"description": "Primary toolset for data processing",
19	"version": "1.3.0",
20	"owner": "team-data"
21	}
22	}

1	curl https://api.bctrl.ai/v1/spaces/id/toolsets/toolsetId \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json"