---
title: "Delete a subaccount"
method: DELETE
path: "/subaccounts/{subaccount_id}"
---

# Delete a subaccount

`DELETE /subaccounts/{subaccount_id}`

Deletes a subaccount by ID.

## Path parameters

- `subaccount_id` string, required — Subaccount ID.

## Headers

- `Authorization` string, required

## Response `200`

200

- DeleteSubaccountResponse200
  - `status` string — Whether the request was successful.
  - `response` SubaccountsSubaccountIdDeleteResponsesContentApplicationJsonSchemaResponse
    - `answer` string

## Other responses

- `400` — 400
- `401` — Missing or invalid API credentials.
- `500` — The subaccount was not deleted. Read `detail.description` for the reason, then retry the same request.
- `502` — The upstream service returned a body this API could not read. The write may or may not have been applied, so re-read the subaccount before retrying.
- `503` — The delete could not be started, so nothing was removed. Retry the same request.

## Changes

- **2026-09-02** `a0a428a2afbe` — 4 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `500`
  - added the non-success response with the status `502`
  - added the non-success response with the status `503`
- **2026-08-22** `292b6010eb31` — 1 info
  - api tag `` removed

[Change history](https://skmtc.dev/synthflow/apis/platform-api/changes/subaccounts/:subaccount_id/delete.md)

---

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