---
title: "Update an organization"
method: PATCH
path: "/organizations/{organization_id}"
tags: ["Organizations"]
---

# Update an organization

`PATCH /organizations/{organization_id}`

Updates an existing organization.

As of API version 2026-05-12, this endpoint no longer accepts `public_metadata` or `private_metadata`.
Use `PATCH /v1/organizations/{organization_id}/metadata` to merge updates into existing metadata, or `PUT /v1/organizations/{organization_id}/metadata` to replace a metadata field entirely.

## Path parameters

- `organization_id` string, required

## Request body

- object
  - `name` string, nullable — The new name of the organization. May not contain URLs or HTML. Max length: 256
  - `slug` string, nullable — The new slug of the organization, which needs to be unique in the instance
  - `max_allowed_memberships` integer, nullable — The maximum number of memberships allowed for this organization
  - `admin_delete_enabled` boolean, nullable — If true, an admin can delete this organization with the Frontend API.
  - `created_at` string, nullable — A custom date/time denoting _when_ the organization was created, specified in RFC3339 format (e.g. `2012-10-20T07:15:20.902Z`).
  - `role_set_key` string, nullable — The key of the [role set](https://clerk.com/docs/guides/organizations/control-access/role-sets) to assign to this organization.

## Response `200`

An organization

- Organization
  - `object` 'organization', required
  - `id` string, required
  - `name` string, required
  - `slug` string, required
  - `image_url` string
  - `has_image` boolean, required
  - `members_count` integer
  - `missing_member_with_elevated_permissions` boolean
  - `pending_invitations_count` integer
  - `max_allowed_memberships` integer, required
  - `admin_delete_enabled` boolean, required
  - `public_metadata` object, required
  - `private_metadata` object
  - `created_by` string
  - `created_at` integer, required — Unix timestamp of creation.
  - `updated_at` integer, required — Unix timestamp of last update.
  - `last_active_at` integer — Unix timestamp of last activity.
  - `role_set_key` string, nullable — The key of the [role set](https://clerk.com/docs/guides/organizations/control-access/role-sets) assigned to this organization.

## Other responses

- `400` — Request was not successful
- `402` — Payment required
- `403` — Authorization invalid
- `404` — Resource not found
- `422` — Invalid request parameters

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/versions/cf036e7951d3/schema)