skills.rest
divinaarmuela
divinaarmuelaCOMMUNITY
Explore all skills by this author →
GitHub

clerk-backend-api

Browse and execute Clerk Backend REST API endpoints with authenticated curl requests.

Updated Apr 19, 2026
Search Tags:#authentication#openapi#rest api#user management#curl#organizations#clerk
One-click install
npx skills add https://github.com/divinaarmuela/Content --skill clerk-backend-api-divinaarmuela
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clerk-backend-api
Source: https://github.com/divinaarmuela/Content/tree/main/.claude/skills/clerk-backend-api
Command: npx skills add https://github.com/divinaarmuela/Content --skill clerk-backend-api-divinaarmuela

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Working with the Clerk Backend API requires knowing exact endpoint paths, request schemas, and authentication patterns. This Skill removes the guesswork by letting you browse the official OpenAPI spec, inspect endpoint details, and execute authenticated requests directly, with built-in safety checks for destructive operations. ## Core Features & Use Cases - Spec Browsing and Inspection: Fetch the latest Clerk OpenAPI spec versions, list tags, and extract full endpoint definitions including referenced schemas. - Fast-Path Templates: Pre-built curl and SDK snippets for common operations like listing users, creating organizations, inviting members, and updating user metadata. - Write-Operation Safety: Mandatory checks for CLERK_SECRET_KEY and CLERK_BAPI_SCOPES before any POST/PATCH/DELETE, plus irreversibility warnings for deletions. - Use Case: You need to create an organization called 'Acme Corp' and invite an admin. The Skill runs the two-step API flow, extracts the organization ID from the first response, and sends the invitation with the correct org:admin role. ## Quick Start Ask the assistant to list all users who signed up in the last 7 days using the Clerk Backend API.

Frequently Asked Questions about clerk-backend-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list users from the Clerk Backend API?▼

Send a GET request to /v1/users with your CLERK_SECRET_KEY as a Bearer token in the Authorization header. Use limit and offset query parameters for pagination, and filter by created_at with a Unix timestamp range to narrow results by signup date.

How do I create an organization and invite a member via the Clerk API?▼

First POST to /v1/organizations with a name and created_by user ID, then extract the organization ID from the response. Next, POST to /v1/organizations/{id}/invitations with the email address and a role of org:admin or org:member.

What is the difference between public, private, and unsafe metadata in Clerk?▼

Public metadata is readable by client and server but writable only server-side, private metadata is server-only for both read and write, and unsafe metadata is readable and writable by both client and server. Use public for plan tiers, private for Stripe IDs, and unsafe only for non-sensitive UI state.

Why does updating Clerk user metadata delete my existing fields?▼

The updateUser call replaces the entire metadata object rather than merging it. Read the existing user first with getUser, spread the current metadata into your new object, then write the merged result back.

What are the Clerk Backend API rate limits?▼

Production allows 1,000 requests per 10 seconds while development allows 100 requests per 10 seconds. Note that currentUser() makes a real API call against the limit, so use auth() instead when you only need session claims.

Can I delete a Clerk user through the Backend API?▼

Yes, send a DELETE request to /v1/users/{user_id} with Bearer authentication. This action is irreversible and permanently destroys the user record, all sessions, memberships, and associated data, so explicit confirmation is required first.

Related Skills

Explore More Software Engineering Skills→
RoyMcCrainRoyMcCrain
1

clerk-backend-api

Manages and updates Clerk Backend resources via authenticated API calls.

Community
Advanced
Athone88Athone88

clerk-webhooks

Verify Clerk webhook signatures and sync user, session, and organization events.

Community
Intermediate
obada-jarasobada-jaras

clerk-webhooks

Process Clerk webhooks to synchronize user, organization, and session events.

Community
Intermediate
clerkclerk
66

clerk-orgs

Manage multi-tenant access and organization scoping for B2B apps using Clerk Organizations.

Official
Advanced