> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Suspend Child Account

> Pause a child account — its API keys stop authenticating and billing pauses.

Suspends a child to immediately stop it from sending: its API keys stop authenticating (`403 account_suspended`) and its billing pauses. Idempotent — a no-op if the child is already suspended. Requires a **parent** key with `accounts.write`. [Reactivate](/api-reference/v2/accounts/reactivate-child) to resume.

## Path Parameters

<ParamField path="child_id" type="integer" required>
  The child account's `accountId`.
</ParamField>

## Examples

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.tracklysms.com/api/v2/accounts/children/1042/suspend \
    -H "X-Api-Key: trk_your_parent_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — Success theme={null}
  {
    "child": {
      "accountId": 1042,
      "name": "Acme West",
      "status": "suspended",
      "plan": "paid",
      "externalIds": { "partnerId": "p_1", "businessId": "b_9", "locationId": "loc_west" },
      "billedByParent": true,
      "createdAt": "2026-07-26T14:03:11.123456"
    }
  }
  ```
</ResponseExample>

## Error Codes

| HTTP Status | Error Code                                                          | Description                                                      |
| ----------- | ------------------------------------------------------------------- | ---------------------------------------------------------------- |
| 404         | `child_not_found`                                                   | No child with that ID under this parent.                         |
| 409         | `child_deleted`                                                     | The child has been deleted.                                      |
| 403         | `not_a_parent_account` / `insufficient_scope` / `sandbox_read_only` | See [Accounts & Hierarchy](/api-reference/v2/accounts/overview). |

<Note>
  Suspending a child does not revoke its keys — reactivating restores them. To permanently disable a key, [revoke it](/api-reference/v2/accounts/revoke-api-key).
</Note>