---
title: "Patch Org"
method: PATCH
path: "/api/v1/orgs/{org_id}"
tags: ["organizations"]
---

# Patch Org

`PATCH /api/v1/orgs/{org_id}`

## Path parameters

- `org_id` string, required

## Headers

- `Authorization` string, nullable

## Request body

- OrganizationUpdate
  - `name` string, nullable
  - `slug` string, nullable
  - `plan` 'free' | 'pro' | 'enterprise'
  - `status` 'pending' | 'active' | 'suspended' | 'deleted'

## Response `200`

Successful Response

- OrganizationRead
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `name` string, required
  - `slug` string, required
  - `workos_org_id` string, required
  - `plan` 'free' | 'pro' | 'enterprise', required
  - `status` 'pending' | 'active' | 'suspended' | 'deleted', required
  - `metronome_customer_id` string, nullable

## Other responses

- `422` — Validation Error

---

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