---
title: "Merge and update metadata for an organization"
method: PATCH
path: "/organizations/{organization_id}/metadata"
tags: ["Organizations"]
---

# Merge and update metadata for an organization

`PATCH /organizations/{organization_id}/metadata`

Update organization metadata attributes by merging existing values with the provided parameters.
Metadata values will be updated via a deep merge.
Deep meaning that any nested JSON objects will be merged as well.
You can remove metadata keys at any level by setting their value to `null`.

## Path parameters

- `organization_id` string, required

## Request body

- object
  - `public_metadata` object — Metadata saved on the organization, that is visible to both your frontend and backend. The new object will be merged with the existing value.
  - `private_metadata` object — Metadata saved on the organization that is only visible to your backend. The new object will be merged with the existing value.

## 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
- `401` — Authentication 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)