---
title: "Update a sub-account"
method: PUT
path: "/v1/sub-organizations/{id}"
tags: ["Sub-accounts"]
---

# Update a sub-account

`PUT /v1/sub-organizations/{id}`

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

## Path parameters

- `id` integer, required

## Request body

- SubAccountsUpdateRequest
  - `name` string, 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).
  - `default_destinations` object — Default webhook URLs for inbound messages and delivery reports.
    - `sms_endpoint` string, uri — Inbound messages webhook URL.
    - `dlr_endpoint` string, uri — Delivery report webhook URL.

## Response `200`

Returns the updated sub-account.

- SubOrganizationResponse — Sub-account details including API key and webhook configurations.
  - `id` integer, required — Sub-account ID.
  - `created_at` string, date-time, required — Date and time the sub-account was created in ISO 8601 format.
  - `name` string, required — Sub-account name.
  - `api_key` string, required — Sub-account API key.
  - `master_organization` integer, 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).
  - `default_destinations` object, required — Default webhook URLs for inbound messages and delivery reports.
    - `sms_endpoint` string, uri, required — Inbound messages webhook URL.
    - `dlr_endpoint` string, uri, required — Delivery report webhook URL.

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `403` — Request failed. The feature is disabled for your account.
- `404` — Request failed. An object with the specified ID is not found.
- `422` — Validation error

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/revisions/b22f170488b6/schema)