Create a space | BCTRL Docs

Create a space. Name, region, and environment are optional; omitted values use server defaults.

AuthorizationBearer

Use Bearer <api-key>.

This endpoint expects an object.

environmentobjectOptional

namestringOptional1-200 characters

regionenumOptional

Created

createdAtdatetime

RFC 3339 timestamp with a UTC offset.

environmentobject

idstring

Unique space identifier generated by BCTRL.

isDefaultboolean

namestring1-200 characters

regionenum

updatedAtdatetime

RFC 3339 timestamp with a UTC offset.

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

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

1	{
2	"createdAt": "2026-07-26T12:00:00Z",
3	"environment": {
4	"ai": {
5	"credentialIds": [
6	"string"
7	],
8	"default": "string"
9	},
10	"storage": {
11	"namespace": "string"
12	},
13	"vault": {
14	"allow": [
15	"string"
16	],
17	"allowRawReads": true,
18	"deny": [
19	"string"
20	]
21	}
22	},
23	"id": "sp_AAAAAAAAAAAAAAAAAAAAAA",
24	"isDefault": true,
25	"name": "string",
26	"region": "us-east-1",
27	"updatedAt": "2026-07-26T12:00:00Z"
28	}