Create Subaccount | BCTRL Docs

Create a subaccount for a tenant, customer, environment, or team. Subaccounts give you a clean boundary for account administration and spend controls.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Request

This endpoint expects an object.

namestringRequired1-200 characters

externalIdstringOptional1-200 characters

limitsobjectOptional

metadatamap from strings to anyOptional

Response

Default Response

createdAtstring

idstring>=1 character

limitsobject

namestring>=1 character

slugstring>=1 character

statusenum

Allowed values:

updatedAtstring

archivedAtstring or null

externalIdstring or null>=1 character

metadatamap from strings to any or null

1	curl -X POST https://api.bctrl.ai/v1/subaccounts \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "Marketing Team Subaccount"
6	}'

1	{
2	"createdAt": "2024-06-01T09:15:00Z",
3	"id": "subacc-8f3b2c7d9a4e",
4	"limits": {
5	"maxActiveRuns": 10,
6	"maxSpaces": 5,
7	"monthlyCreditLimitMicroUsd": 5000000
8	},
9	"name": "Marketing Team Subaccount",
10	"slug": "marketing-team-subaccount",
11	"status": "active",
12	"updatedAt": "2024-06-01T09:15:00Z",
13	"archivedAt": "null",
14	"externalId": "mktg-team-2024",
15	"metadata": {}
16	}