Create a subaccount | BCTRL Docs

{
  "createdAt": "string",
  "defaultSpaceId": "string",
  "id": "V1StGXR8_Z5jdHi6B-myT",
  "limits": {
    "maxActiveRuns": 1,
    "maxSpaces": 1,
    "monthlyCreditLimit": 1.1
  },
  "name": "Production browser",
  "status": "active",
  "updatedAt": "string",
  "archivedAt": "string",
  "externalId": "string",
  "metadata": {},
  "usage": {
    "computedAt": "2026-07-26T12:00:00Z",
    "credits": {
      "limit": 1.1,
      "used": 1.1
    },
    "period": {
      "endsAt": "2026-07-26T12:00:00Z",
      "startedAt": "2026-07-26T12:00:00Z"
    },
    "runs": {
      "active": 1,
      "limit": 1
    },
    "spaces": {
      "limit": 1,
      "used": 1
    },
    "subaccountId": "V1StGXR8_Z5jdHi6B-myT"
  }
}

Create a subaccount for a tenant, customer, environment, or team. Optional limits can be provided inline.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Request

This endpoint expects an object.

namestringRequired1-200 characters

externalIdstringOptional1-200 characters

limitsobjectOptional

metadataobjectOptional

Response

Created

createdAtstring

defaultSpaceIdstringformat: "uuid"

idstring1-64 characters

Opaque identifier for a BCTRL subaccount.

limitsobject

namestring1-200 characters

Customer-facing resource name. 1–200 characters.

statusenum

updatedAtstring

archivedAtstring or nullOptional

externalIdstring or nullOptional

metadataobject or nullOptional

usageobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

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