clerk-backend-api — quality + safety report

---
name: clerk-backend-api
description: "Clerk Backend API skill. Use when working with Clerk Backend for public, jwks, clients. Covers 195 endpoints."
version: 1.0.0
generator: lapsh
---

# Clerk Backend API
API version: 2025-11-10

## Auth
Bearer bearer

## Base URL
https://api.clerk.com/v1

## Setup
1. Set Authorization header with your Bearer token
2. GET /public/interstitial -- verify access
3. POST /clients/verify -- create first verify

## Endpoints

195 endpoints across 37 groups. See references/api-spec.lap for full details.

### public
| Method | Path | Description |
|--------|------|-------------|
| GET | /public/interstitial | Returns the markup for the interstitial page |

### jwks
| Method | Path | Description |
|--------|------|-------------|
| GET | /jwks | Retrieve the JSON Web Key Set of the instance |

### clients
| Method | Path | Description |
|--------|------|-------------|
| GET | /clients | List all clients |
| POST | /clients/verify | Verify a client |
| GET | /clients/{client_id} | Get a client |

### email_addresses
| Method | Path | Description |
|--------|------|-------------|
| POST | /email_addresses | Create an email address |
| GET | /email_addresses/{email_address_id} | Retrieve an email address |
| DELETE | /email_addresses/{email_address_id} | Delete an email address |
| PATCH | /email_addresses/{email_address_id} | Update an email address |

### phone_numbers
| Method | Path | Description |
|--------|------|-------------|
| POST | /phone_numbers | Create a phone number |
| GET | /phone_numbers/{phone_number_id} | Retrieve a phone number |
| DELETE | /phone_numbers/{phone_number_id} | Delete a phone number |
| PATCH | /phone_numbers/{phone_number_id} | Update a phone number |

### sessions
| Method | Path | Description |
|--------|------|-------------|
| GET | /sessions | List all sessions |
| POST | /sessions | Create a new active session |
| GET | /sessions/{session_id} | Retrieve a session |
| POST | /sessions/{session_id}/refresh | Refresh a session |
| POST | /sessions/{session_id}/revoke | Revoke a session |
| POST | /sessions/{session_id}/tokens | Create a session token |
| POST | /sessions/{session_id}/tokens/{template_name} | Create a session token from a JWT template |

### templates
| Method | Path | Description |
|--------|------|-------------|
| GET | /templates/{template_type} | List all templates |
| GET | /templates/{template_type}/{slug} | Retrieve a template |
| PUT | /templates/{template_type}/{slug} | Update a template for a given type and slug |
| POST | /templates/{template_type}/{slug}/revert | Revert a template |
| POST | /templates/{template_type}/{slug}/preview | Preview changes to a template |
| POST | /templates/{template_type}/{slug}/toggle_delivery | Toggle the delivery by Clerk for a template of a given type and slug |

### users
| Method | Path | Description |
|--------|------|-------------|
| GET | /users | List all users |
| POST | /users | Create a new user |
| GET | /users/count | Count users |
| GET | /users/{user_id} | Retrieve a user |
| PATCH | /users/{user_id} | Update a user |
| DELETE | /users/{user_id} | Delete a user |
| POST | /users/{user_id}/ban | Ban a user |
| POST | /users/{user_id}/unban | Unban a user |
| POST | /users/ban | Ban multiple users |
| POST | /users/unban | Unban multiple users |
| POST | /users/{user_id}/lock | Lock a user |
| POST | /users/{user_id}/unlock | Unlock a user |
| POST | /users/{user_id}/profile_image | Set user profile image |
| DELETE | /users/{user_id}/profile_image | Delete user profile image |
| PATCH | /users/{user_id}/metadata | Merge and update a user's metadata |
| GET | /users/{user_id}/billing/subscription | Retrieve a user's billing subscription |
| GET | /users/{user_id}/oauth_access_tokens/{provider} | Retrieve the OAuth access token of a user |
| GET | /users/{user_id}/organization_memberships | Retrieve all memberships for a user |
| GET | /users/{user_id}/organization_invitations | Retrieve all invitations for a user |
| POST | /users/{user_id}/verify_password | Verify the password of a user |
| POST | /users/{user_id}/verify_totp | Verify a TOTP or backup code for a user |
| DELETE | /users/{user_id}/mfa | Disable a user's MFA methods |
| DELETE | /users/{user_id}/backup_code | Disable all user's Backup codes |
| DELETE | /users/{user_id}/passkeys/{passkey_identification_id} | Delete a user passkey |
| DELETE | /users/{user_id}/web3_wallets/{web3_wallet_identification_id} | Delete a user web3 wallet |
| DELETE | /users/{user_id}/totp | Delete all the user's TOTPs |
| DELETE | /users/{user_id}/external_accounts/{external_account_id} | Delete External Account |
| POST | /users/{user_id}/password/set_compromised | Set a user's password as compromised |
| POST | /users/{user_id}/password/unset_compromised | Unset a user's password as compromised |

### invitations
| Method | Path | Description |
|--------|------|-------------|
| POST | /invitations | Create an invitation |
| GET | /invitations | List all invitations |
| POST | /invitations/bulk | Create multiple invitations |
| POST | /invitations/{invitation_id}/revoke | Revokes an invitation |

### organization_invitations
| Method | Path | Description |
|--------|------|-------------|
| GET | /organization_invitations | Get a list of organization invitations for the current instance |

### allowlist_identifiers
| Method | Path | Description |
|--------|------|-------------|
| GET | /allowlist_identifiers | List all identifiers on the allow-list |
| POST | /allowlist_identifiers | Add identifier to the allow-list |
| DELETE | /allowlist_identifiers/{identifier_id} | Delete identifier from allow-list |

### blocklist_identifiers
| Method | Path | Description |
|--------|------|-------------|
| GET | /blocklist_identifiers | List all identifiers on the block-list |
| POST | /blocklist_identifiers | Add identifier to the block-list |
| DELETE | /blocklist_identifiers/{identifier_id} | Delete identifier from block-list |

### beta_features
| Method | Path | Description |
|--------|------|-------------|
| PATCH | /beta_features/instance_settings | Update instance settings |
| PUT | /beta_features/domain | Update production instance domain |

### actor_tokens
| Method | Path | Description |
|--------|------|-------------|
| POST | /actor_tokens | Create actor token |
| POST | /actor_tokens/{actor_token_id}/revoke | Revoke actor token |

### domains
| Method | Path | Description |
|--------|------|-------------|
| GET | /domains | List all instance domains |
| POST | /domains | Add a domain |
| DELETE | /domains/{domain_id} | Delete a satellite domain |
| PATCH | /domains/{domain_id} | Update a domain |

### instance
| Method | Path | Description |
|--------|------|-------------|
| GET | /instance | Fetch the current instance |
| PATCH | /instance | Update instance settings |
| PATCH | /instance/restrictions | Update instance restrictions |
| GET | /instance/protect | Get instance protect settings |
| PATCH | /instance/protect | Update instance protect settings |
| POST | /instance/change_domain | Update production instance domain |
| PATCH | /instance/organization_settings | Update instance organization settings |

### webhooks
| Method | Path | Description |
|--------|------|-------------|
| POST | /webhooks/svix | Create a Svix app |
| DELETE | /webhooks/svix | Delete a Svix app |
| POST | /webhooks/svix_url | Create a Svix Dashboard URL |

### jwt_templates
| Method | Path | Description |
|--------|------|-------------|
| GET | /jwt_templates | List all templates |
| POST | /jwt_templates | Create a JWT template |
| GET | /jwt_templates/{template_id} | Retrieve a template |
| PATCH | /jwt_templates/{template_id} | Update a JWT template |
| DELETE | /jwt_templates/{template_id} | Delete a Template |

### machines
| Method | Path | Description |
|--------|------|-------------|
| GET | /machines | Get a list of machines for an instance |
| POST | /machines | Create a machine |
| GET | /machines/{machine_id} | Retrieve a machine |
| PATCH | /machines/{machine_id} | Update a machine |
| DELETE | /machines/{machine_id} | Delete a machine |
| GET | /machines/{machine_id}/secret_key | Retrieve a machine secret key |
| POST | /machines/{machine_id}/secret_key/rotate | Rotate a machine's secret key |
| POST | /machines/{machine_id}/scopes | Create a machine scope |
| DELETE | /machines/{machine_id}/scopes/{other_machine_id} | Delete a machine scope |

### organizations
| Method | Path | Description |
|--------|------|-------------|
| GET | /organizations | Get a list of organizations for an instance |
| POST | /organizations | Create an organization |
| GET | /organizations/{organization_id} | Retrieve an organization by ID or slug |
| PATCH | /organizations/{organization_id} | Update an organization |
| DELETE | /organizations/{organization_id} | Delete an organization |
| PATCH | /organizations/{organization_id}/metadata | Merge and update metadata for an organization |
| PUT | /organizations/{organization_id}/logo | Upload a logo for the organization |
| DELETE | /organizations/{organization_id}/logo | Delete the organization's logo. |
| GET | /organizations/{organization_id}/billing/subscription | Retrieve an organization's billing subscription |
| POST | /organizations/{organization_id}/invitations | Create and send an organization invitation |
| GET | /organizations/{organization_id}/invitations | Get a list of organization invitations |
| POST | /organizations/{organization_id}/invitations/bulk | Bulk create and send organization invitations |
| GET | /organizations/{organization_id}/invitations/pending | Get a list of pending organization invitations |
| GET | /organizations/{organization_id}/invitations/{invitation_id} | Retrieve an organization invitation by ID |
| POST | /organizations/{organization_id}/invitations/{invitation_id}/revoke | Revoke a pending organization invitation |
| POST | /organizations/{organization_id}/memberships | Create a new organization membership |
| GET | /organizations/{organization_id}/memberships | Get a list of all members of an organization |
| PATCH | /organizations/{organization_id}/memberships/{user_id} | Update an organization membership |
| DELETE | /organizations/{organization_id}/memberships/{user_id} | Remove a member from an organization |
| PATCH | /organizations/{organization_id}/memberships/{user_id}/metadata | Merge and update organization membership metadata |
| POST | /organizations/{organization_id}/domains | Create a new organization domain. |
| GET | /organizations/{organization_id}/domains | Get a list of all domains of an organization. |
| PATCH | /organizations/{organization_id}/domains/{domain_id} | Update an organization domain. |
| DELETE | /organizations/{organization_id}/domains/{domain_id} | Remove a domain from an organization. |

### organization_roles
| Method | Path | Description |
|--------|------|-------------|
| GET | /organization_roles | Get a list of organization roles |
| POST | /organization_roles | Create an organization role |
| GET | /organization_roles/{organization_role_id} | Retrieve an organization role |
| PATCH | /organization_roles/{organization_role_id} | Update an organization role |
| DELETE | /organization_roles/{organization_role_id} | Delete an organization role |
| POST | /organization_roles/{organization_role_id}/permissions/{permission_id} | Assign a permission to an organization role |
| DELETE | /organization_roles/{organization_role_id}/permissions/{permission_id} | Remove a permission from an organization role |

### organization_domains
| Method | Path | Description |
|--------|------|-------------|
| GET | /organization_domains | List all organization domains |

### proxy_checks
| Method | Path | Description |
|--------|------|-------------|
| POST | /proxy_checks | Verify the proxy configuration for your domain |

### redirect_urls
| Method | Path | Description |
|--------|------|-------------|
|

… (truncated)