---
title: "Update a sub-account"
method: PATCH
path: "/v1/sub_accounts/{id}"
tags: ["subAccounts"]
---

# Update a sub-account

`PATCH /v1/sub_accounts/{id}`

Activates or deactivates a sub-account. Deactivation causes every API key belonging to the sub-account to return 401, while retaining its data and keys. Re-enabling restores access.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `enabled` boolean, required

## Response `200`

sub-account updated

- TypeSubAccount — A customer account provisioned and managed by a parent partner account
  - `object` 'sub_account', required
  - `id` string, uuid, required
  - `name` string, required
  - `external_id` string, nullable, required — Idempotency key supplied by the parent account, unique within that parent
  - `enabled` boolean, required
  - `products` string[], required
  - `created_at` string, date-time, required

## Other responses

- `403` — sub-account provisioning not enabled
- `404` — sub-account not found

## Changes

- **2026-09-03** `ac0d9be94846` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/middesk/apis/middesk-api/changes/v1/sub_accounts/:id/patch.md)

---

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