May 5, 2026 | Synthflow

Subaccounts API improvements: New permission and quota fields

We’ve improved the Subaccounts API with more options to manage subaccounts, including explicit permission mutations, finer-grained quota controls, and additional permission flags returned.

The legacy permissions object on Update Subaccount is no longer accepted for permission changes; use grant_permissions and revoke_permissions instead.

New request fields on POST and PUT Subaccount

Field	Description
`concurrency`	Maximum simultaneous calls.
`max_agents`	Maximum agents the subaccount can create.
`max_minutes`	Minute allocation for the subaccount.
`max_workflow_runs`	Workflow-run allocation for the subaccount.
`grant_permissions`	Permissions to grant. See the supported values.
`revoke_permissions`	Permissions to revoke. See the supported values.

New response fields added to the permissions object returned by GET Subaccount:

Field	Description
`inbound`	Can create inbound voice agents.
`outbound`	Can create outbound voice agents.
`widget`	Can create web widget agents.
`chat`	Can create chat agents.
`logs`	Can access call, chat, API, and webhook logs.
`simulations`	Can access call simulations.
`analytics`	Can view the analytics dashboard.

Updated endpoints:

Endpoint	Title
POST /subaccounts	Create a subaccount
PUT /subaccounts/{subaccount_id}	Update a subaccount
GET /subaccounts/{subaccount_id}	Get a subaccount
GET /subaccounts	List subaccounts