Create a toolset | BCTRL Docs

Create an ordered reusable bundle of built-in and custom tools.

AuthorizationBearer

Use Bearer <api-key>.

This endpoint expects an object.

namestringRequired1-200 characters

descriptionstring or nullOptional<=2000 characters

spaceIdstring or "default"Optional

toolslist of enums or stringsOptional

Created

createdAtdatetime

RFC 3339 timestamp with a UTC offset.

descriptionstring or null<=2000 characters

idstring

Unique toolset identifier generated by BCTRL.

namestring1-200 characters

spaceIdstring

Unique space identifier generated by BCTRL.

toolslist of enums or strings

updatedAtdatetime

RFC 3339 timestamp with a UTC offset.

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

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

1	{
2	"createdAt": "2026-07-26T12:00:00Z",
3	"description": "string",
4	"id": "tset_AAAAAAAAAAAAAAAAAAAAAA",
5	"name": "string",
6	"spaceId": "sp_AAAAAAAAAAAAAAAAAAAAAA",
7	"tools": [
8	"stagehand.act"
9	],
10	"updatedAt": "2026-07-26T12:00:00Z"
11	}