Docs

updateOrganizationMetadata()

Updates the metadata associated with the specified organization ID.

function updateOrganizationMetadata: (organizationId: string, params: UpdateOrganizationMetadataParams) => Promise<Organization>;
  • Name
    organizationId
    Type
    string
    Description

    The ID of the organization to update.

  • Name
    publicMetadata?
    Type
    Record<string, unknown>
    Description

    Metadata saved on the organization, that is visible to both your Frontend and Backend APIs.

  • Name
    privateMetadata?
    Type
    Record<string, unknown>
    Description

    Metadata saved on the organization that is only visible to your Backend API.

updateOrganizationMetadata() example

In this example, you can see that the returned Organization object has its publicMetadata property updated with the new metadata provided.

const organizationId = 'org_2ZUtbk2yvnFGItdeze1ivCh3uqh';

const response = await clerkClient.organizations.updateOrganizationMetadata(organizationId, {
  publicMetadata:{
    "example": "metadata"
  }
});

console.log(response);
/*
_Organization {
  id: 'org_2ZUtbk2yvnFGItdeze1ivCh3uqh',
  name: 'test',
  slug: 'test',
  imageUrl: 'https://img.clerk.com/eyJ0eXBlIjoiZGVmYXVsdCIsImlpZCI6Imluc18yVjdKRFdyclJwRmZFZTlqQUM2dWpSMG8xSlQiLCJyaWQiOiJvcmdfMlpVdGJrMnl2bkZHSXRkZXplMWl2Q2gzdXFoIiwiaW5pdGlhbHMiOiJUIn0',
  hasImage: false,
  createdBy: 'user_2V7JJKmoA9HqzHhfMqK5cpgLl56',
  createdAt: 1702488558853,
  updatedAt: 1706722339338,
  publicMetadata: { example: 'metadata' },
  privateMetadata: {},
  maxAllowedMemberships: 3,
  adminDeleteEnabled: true,
  members_count: undefined
}
*/

Backend API (BAPI) endpoint

This method in the SDK is a wrapper around the BAPI endpoint PATCH/organizations/{organization_id}/metadata. See the BAPI reference for more details.

Feedback

What did you think of this content?