Sign in

v50

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-06-16122182589.7 KB
Sub-accounts

Update a sub-account

Replaces the configuration of the sub-account identified by id. Omitted fields revert to their defaults.

put/v1/sub-organizations/{id}

Path parameters

idinteger required
Example:123

The unique ID of the sub-account.

Request body

namestring required

Sub-account name.

status'enabled' | 'disabled'

Status of the subaccount. One of enabled (the subaccount is active and can be used) or disabled (the subaccount is suspended).

Example request

{
  "name": "Updated Company Name",
  "status": "enabled",
  "default_destinations": {
    "sms_endpoint": "https://examples.com/sms",
    "dlr_endpoint": "https://examples.com/dlr"
  }
}

Response

Returns the updated sub-account.

idinteger required

Sub-account ID.

created_atstring date-time required

Date and time the sub-account was created in ISO 8601 format.

namestring required

Sub-account name.

api_keystring required

Sub-account API key.

master_organizationinteger required

Master account ID.

status'enabled' | 'disabled' required

Status of the subaccount. One of enabled (the subaccount is active and can be used) or disabled (the subaccount is suspended).

Example response

{
  "id": 123,
  "created_at": "2023-06-15T10:30:00Z",
  "name": "My sub-account",
  "api_key": "abc123def456",
  "master_organization": 456,
  "status": "enabled",
  "default_destinations": {
    "sms_endpoint": "https://examples.com/sms",
    "dlr_endpoint": "https://examples.com/dlr"
  }
}