---
title: "Update an account"
method: PATCH
path: "/account/{id}"
tags: ["Account"]
---

# Update an account

`PATCH /account/{id}`

Updates a specific account.

## Path parameters

- `id` integer, required

## Request body

- AccountWrite
  - `name` string, required — The name of the account. > ℹ️ **Note:** Changing the accounts's name **does not change the slug**, as doing so could break connections with existing applications and services.
  - `status` 'active' | 'inactive', required — The status of the account.

## Response `204`

An object representing the account.

- Account
  - `id` integer, required — A system-wide unique ID for the account.
  - `name` string, required — The account name.
  - `slug` string, required — An organization-wide unique slug for the account.
  - `organization_id` integer, required — The ID of the organization that owns this account.
  - `status` 'active' | 'inactive' | 'deleted', required — The status of the account. The `deleted` value is only returned in responses to `GET /account/{id}?show_deleted=true` for accounts that have been soft-deleted; it cannot be set via create or update.
  - `deleted_at` string, date-time, nullable — The timestamp at which the account was soft-deleted, or `null` if the account is still active. Only populated in responses to `GET /account/{id}?show_deleted=true`.
  - `metadata` MetadataComponent — The metadata loaded via the metadata catalog API.
    - `key` string — The key of the metadata.
    - `value` string — The value of the metadata.
    - `additional_properties` object — Additional metadata properties, including schemas and tags.
      - `schemas` object[] — The JSON schemas of the metadata.
      - `tags` object[] — Tags associated with the metadata.
        - `key` string
        - `value` string

## Other responses

- `4XX` — Client error responses due to invalid input or missing parameters.
- `5XX` — Internal server error due to an unexpected issue.

---

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