v2

latestOpenAPI 3.1.02026-08-05100545344.4 KB

Update a subaccount

put/subaccounts/{subaccount_id}

Path parameters

subaccount_idstring required

Subaccount ID.

Headers

Authorizationstring required

Bearer authentication

Request body

subaccount_namestring

The name for the new subaccount. This should be a unique identifier that distinguishes it from other subaccounts within the main account.

invite_user_emailstring

This is the email address of the user you wish to invite to the subaccount. When this optional parameter is filled in, a "sign in" link will be generated and sent back in the response. The user can use this link to sign in and set up their account.

twilio_account_sidstring

This is the Twilio SID of the subaccount.

twilio_auth_tokenstring

This is the Twilio Token of the subaccount.

concurrencyinteger

The maximum calls the subaccount can handle at once.

max_agentsinteger nullable

The maximum number of agents the subaccount is allowed to create. Null if no limit is set.

max_minutesinteger nullable

The maximum number of minutes allocated to this subaccount. Null if no limit is set.

max_workflow_runsinteger nullable

The maximum number of workflow runs allocated to this subaccount. Null if no limit is set.

grant_permissionsSubaccountsSubaccountIdPutRequestBodyContentApplicationJsonSchemaGrantPermissionsItems[]

Permissions to grant to the subaccount. Duplicate values are not allowed, and any value also present in revoke_permissions is rejected by the API.

revoke_permissionsSubaccountsSubaccountIdPutRequestBodyContentApplicationJsonSchemaRevokePermissionsItems[]

Permissions to revoke from the subaccount. Duplicate values are not allowed, and any value also present in grant_permissions is rejected by the API.

operation_type'import' | 'return'

The type of operation to perform. You can import objects from the parent workspace to a subaccount or return objects from a subaccount in some cases.

Response

200

statusstring