---
title: "Update a subaccount"
method: PUT
path: "/subaccounts/{subaccount_id}"
tags: [""]
---

# Update a subaccount

`PUT /subaccounts/{subaccount_id}`

## Path parameters

- `subaccount_id` string, required — Subaccount ID.

## Headers

- `Authorization` string, required

## Request body

- object
  - `subaccount_name` string — The name for the new subaccount. This should be a unique identifier that distinguishes it from other subaccounts within the main account.
  - `invite_user_email` string — 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.
  - `pricing_tiers_attach` SubaccountsSubaccountIdPutRequestBodyContentApplicationJsonSchemaPricingTiersAttachItems[] — Pricing tier IDs that this subaccount can choose from when selecting a subscription plan.
    - `pricing_tier_id` string, required — The ID of the Synthflow pricing tier.
  - `pricing_tiers_detach` SubaccountsSubaccountIdPutRequestBodyContentApplicationJsonSchemaPricingTiersDetachItems[] — Pricing tiers will be removed from this subaccount and will no longer be available for selection when choosing a subscription plan.
    - `pricing_tier_id` string, required — The ID of the Synthflow pricing tier.
  - `import_subscription` SubaccountsSubaccountIdPutRequestBodyContentApplicationJsonSchemaImportSubscription — This section is used when you want to import an existing Stripe subscription for the subaccount
    - `stripe_subscription_id` string — The ID of the existing Stripe subscription you want to import. This is typically used when the subaccount already has a subscription set up in Stripe, and you want to link it to their Synthflow account.
    - `synthflow_price_id` string — The ID of the Synthflow pricing tier that corresponds to the imported Stripe subscription. This allows you to map the external Stripe subscription to an equivalent plan within Synthflow.
  - `twilio_account_sid` string — This is the Twilio SID of the subaccount.
  - `twilio_auth_token` string — This is the Twilio Token of the subaccount.
  - `concurrency` integer — The maximum calls the subaccount can handle at once.
  - `max_agents` integer, nullable — The maximum number of agents the subaccount is allowed to create. Null if no limit is set.
  - `max_minutes` integer, nullable — The maximum number of minutes allocated to this subaccount. Null if no limit is set.
  - `max_workflow_runs` integer, nullable — The maximum number of workflow runs allocated to this subaccount. Null if no limit is set.
  - `grant_permissions` SubaccountsSubaccountIdPutRequestBodyContentApplicationJsonSchemaGrantPermissionsItems[] — 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_permissions` SubaccountsSubaccountIdPutRequestBodyContentApplicationJsonSchemaRevokePermissionsItems[] — 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.
  - `products` SubaccountsSubaccountIdPutRequestBodyContentApplicationJsonSchemaProducts — Objects to be imported to or returned from the subaccount_id
    - `phone_numbers` SubaccountsSubaccountIdPutRequestBodyContentApplicationJsonSchemaProductsPhoneNumbersItems[] — The list of numbers to be imported to or returned from the subaccount_id
      - `number` string — The E.164 formatted phone number

## Response `200`

200

- UpdateSubaccountResponse200
  - `status` string
  - `response` SubaccountsSubaccountIdPutResponsesContentApplicationJsonSchemaResponse
    - `subaccount_id` string — Subaccount ID.
    - `api_key` string
    - `user_email` string
    - `sign_in_link` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/synthflow/apis/platform-api.md) · [All operations](https://skmtc.net/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthflow/platform-api/versions/decb652b52e0/schema)