Update 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"
  }
}

Update one subaccount name, external identifier, metadata, or configured limits.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

subaccountIdstringRequired1-64 characters

Opaque identifier for a BCTRL subaccount.

Request

This endpoint expects an object.

externalIdstring or nullOptional1-200 characters

limitsobjectOptional

metadataobject or nullOptional

namestringOptional1-200 characters

Response

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

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

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