Update Enterprise Member Status

PATCH/enterprise/v1/sub-accounts/{subAccountId}/status

status is required: active or suspended. Suspension disables active member keys; reactivation restores keys disabled by that suspension.

Authentication

MANAGEMENT / PROVISIONING key with tenant:members:write.

Authorization: Bearer <CONTROL_KEY>

Any subAccountId must belong to the authenticated enterprise. hash is a metadata identifier, never a raw key.

Approval and retries

Approval-enabled enterprises require Idempotency-Key and may receive HTTP 409 / APPROVAL_REQUIRED with data.operation.executed=false. Nothing has executed at that point. Other enterprises execute directly; do not assume arbitrary POST requests support idempotent retries.

Approval and retry guide

Path parameters

subAccountIdstringrequired

10-digit public member ID / 10 位成员编号

Request body

statusstringrequired

active | suspended

Fields use camelCase. Required and optional fields are described above.

JSON

1{
2  "status": "suspended"
3}

Response

HTTP 200; code: 200. Values below are illustrative; fields use camelCase.

codeinteger

200

dataobject | null

data.subAccountIdstring

data.usernamestring

data.displayNamestring

data.statusstring

data.parentAccountIdstring

data.createdAtstring

data.lastLoginAtstring | null

data.modelRestrictionstring

data.modelCountnumber

Errors

Check both HTTP status and code; on failure inspect serviceCode, msg and traceId. Invalid credentials receive no data; missing scopes return API_KEY_SCOPE_DENIED. Cross-tenant resources are inaccessible. Acceptance or pending approval does not mean business completion.

Request

Shell

1curl -X PATCH "https://api.token360.ai/enterprise/v1/sub-accounts/{subAccountId}/status" \
2  -H "Authorization: Bearer $CONTROL_KEY" \
3  -H "Idempotency-Key: <UNIQUE_INTENT_ID>" \
4  -H "Content-Type: application/json" \
5  --data '{"status": "suspended"}'

Response

JSON

1{
2  "code": 200,
3  "msg": "success",
4  "data": {
5    "subAccountId": "1000000001",
6    "username": "team_app",
7    "displayName": "Team App",
8    "status": "suspended",
9    "parentAccountId": "enterprise-account",
10    "createdAt": "2026-11-03 00:00:00",
11    "lastLoginAt": null,
12    "modelRestriction": "INHERIT",
13    "modelCount": 0
14  }
15}

Was this page helpful?