This repo contains Clerk's public OpenAPI specs.
The Frontend API is meant to be accessed from a browser or native clients. It powers the client-side functionality used by Clerk's SDKs.
Versioned specs are in the fapi/ directory.
The Backend API is meant to be accessed by backend servers. Use it to manage resources and perform operations outside the context of a user session, such as coordinating with third parties or managing configuration.
Versioned specs are in the bapi/ directory.
Webhook event payload schemas are in the webhooks/ directory.
The Platform API spec is in the platform/ directory. This spec is currently in beta.
Each API directory contains dated YAML files (e.g. 2025-11-10.yml) representing the spec for that API version. Use the most recent file for the latest version.
This repo is not meant to be contributed to directly. The specs are synced from an internal repository either manually or via CI.
- Clerk employees: Bring up changes internally and you'll be pointed to the source repo.
- External contributors: Please open an issue!