Clerk

Clerk Organizations API

Organizations are used to group members under a common entity and provide shared access to resources.

GitHub OpenAPI

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /organizations List organizations in the instance · Get a List of Organizations for an Instance #
Ask an LLM
“How do I list every organization in my instance, newest first?”
“Can I include member counts when listing organizations?”
Tell an agent
List all organizations with their member counts.
Search organizations matching {query}.
POST /organizations Create an organization · Create an Organization #
Ask an LLM
“How do I create an organization for a customer from my backend?”
“Can I set a custom slug and a membership cap when creating an organization?”
Tell an agent
Create an organization named {name}.
Create organization {name} with slug {slug}, owned by user {created_by}.
GET /organizations/{organization_id} Retrieve an organization by ID or slug · Retrieve an Organization by ID or Slug #
Ask an LLM
“How do I fetch one organization by its ID or slug?”
“Can I get a single organization's member count along with its details?”
Tell an agent
Get organization {organization_id}.
Show the details and member count of organization {organization_id}.
PATCH /organizations/{organization_id} Update an organization · Update an Organization #
Ask an LLM
“How do I rename an organization or change its slug from the backend?”
“Can I raise the maximum allowed memberships on an existing organization?”
Tell an agent
Rename organization {organization_id} to {name}.
Change the slug of organization {organization_id} to {slug}.
DELETE /organizations/{organization_id} Delete an organization · Delete an Organization #
Ask an LLM
“How do I permanently delete an organization and its memberships?”
“Is deleting an organization reversible?”
Tell an agent destructive · confirm first
Delete organization {organization_id}.
Permanently remove organization {organization_id} with all its memberships and invitations.
PATCH /organizations/{organization_id}/metadata Merge metadata into an organization · Merge and Update Metadata for an Organization #
Ask an LLM
“How do I add a key to an organization's metadata without replacing the rest?”
“Does organization metadata merging handle nested JSON?”
Tell an agent
Merge {private_metadata} into the private metadata of organization {organization_id}.
Deep-merge {public_metadata} into organization {organization_id}'s public metadata.
GET /organizations/{organization_id}/billing/subscription Get an organization's billing subscription · Retrieve an Organization's Billing Subscription #
Ask an LLM
“Which plans is an organization currently subscribed to?”
“How do I check an organization's subscription payment status?”
Tell an agent
Show the billing subscription for organization {organization_id}.
Get the active plans and payment status of organization {organization_id}.
GET /organizations/{organization_id}/billing/credits Get an organization's credit balance · Retrieve an Organization's Credit Balance #
Ask an LLM
“How much billing credit does an organization have left?”
“Can I see an organization's credits before its next recurring charge?”
Tell an agent
Show the credit balance of organization {organization_id}.
Look up how many credits organization {organization_id} has available.
POST /organizations/{organization_id}/billing/credits Adjust an organization's credit balance · Adjust an Organization's Credit Balance #
Ask an LLM
“How do I grant billing credit to an organization?”
“Can I decrease an organization's credits, and are duplicate adjustments safe?”
Tell an agent
Increase organization {organization_id}'s credits by {amount} with idempotency key {idempotency_key}.
Apply a {action} of {amount} to organization {organization_id}'s credits with note {note} and key {idempotency_key}.

Documentation

📖
Documentation
https://clerk.com/docs/reference/backend-api
📖
APIReference
https://clerk.com/docs/reference/backend-api
📖
GettingStarted
https://clerk.com/docs/quickstarts/overview
📖
Authentication
https://clerk.com/docs/backend-requests/making/jwt-templates
📖
Documentation
https://clerk.com/docs
📖
Documentation
https://clerk.com/docs/webhooks/overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/clerk-com/refs/heads/main/openapi/clerk-com-organizations-api-openapi.yml

Other Resources

🔗
SpectralRuleset
https://raw.githubusercontent.com/api-evangelist/clerk-com/refs/heads/main/rules/clerk-rules.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/clerk-com:clerk-com-organizations-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clerk-com-organizations-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clerk Backend Organizations API
  x-logo:
    url: https://clerk.com/_next/image?url=%2Fimages%2Fclerk-logo.svg&w=96&q=75
    altText: Clerk docs
    href: https://clerk.com/docs
  contact:
    email: support@clerk.com
    name: Clerk Platform Team
    url: https://clerk.com/support
  description: 'The Clerk REST Backend API, meant to be accessed by backend servers.


    ### Versions


    When the API changes in a way that isn''t compatible with older versions, a new version is released.

    Each version is identified by its release date, e.g. `2025-04-10`. For more information, please see Clerk API Versions.


    Please see https://clerk.com/docs for more information.'
  version: '2025-11-10'
  termsOfService: https://clerk.com/terms
  license:
    name: MIT
    url: https://github.com/clerk/openapi-specs/blob/main/LICENSE
servers:
- url: https://api.clerk.com/v1
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (52 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/clerk-com/refs/heads/main/openapi/clerk-com-organizations-api-openapi.yml