How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Clerk

Clerk Sessions API

The Session object is an abstraction over an HTTP session.It models the period of information exchange between a user and the server.Sessions are created when a user successfully goes through the sign in or sign up flows.

Documentation Provider Profile APIs.io OpenAPI GitHub

Clerk Sessions API is one of 104 APIs that Clerk publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Sessions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

This API exposes 19 operations across 18 paths, and defines 51 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://api.clerk.com/v1, https://{domain}.clerk.accounts.dev.

19 operations 18 paths 51 schemas 1 DELETE3 GET15 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.clerk.com/v1
Authentication
HTTP Bearer, API Key, API Key, HTTP Bearer, API Key, HTTP Basic
Terms of Service
View terms
Resource Areas
1

Authentication & Security 6

Clerk Sessions API declares 6 security schemes for authenticating requests. It accepts HTTP bearer tokens (sk__) (bearerAuth). An API key is passed in the cookie as __client (ProductionBrowser). An API key is passed in the query as __dev_session (DevBrowser). It accepts HTTP bearer tokens (ProductionNativeApp). An API key is passed in the query as _is_native (ProductionNativeFlag). It accepts HTTP basic authentication (ClientCredentials).

  • bearerAuth — Secret key, obtained under "API Keys" in the Clerk Dashboard.
  • ProductionBrowser — The Client API token sent in the form of a browser cookie. Used to authenticate production browser applications.
  • DevBrowser — A Dev Browser API token sent as a query parameter. Used to authenticate only dev instances. To generate a dev instance API token you must first make a request…
  • ProductionNativeApp — The Client API token sent in the Authorization header. Used to authenticate native applications.
  • ProductionNativeFlag — If sent and the value is true, it instructs the server to parse the API token from the Authorization header. It should always be set to true when using the Aut…
  • ClientCredentials — HTTP Basic Authentication using Client ID as username and Client Secret as password.

Paths & Operations 19

Across 18 paths, the API surfaces 19 operations — 1 DELETE, 3 GET, 15 POST. Each is listed below with its method, path, parameters, and response codes.

Sessions 19

The Session object is an abstraction over an HTTP session. It models the period of information exchange between a user and the server. Sessions are created when a user successfull…

GET
/sessions
List All Sessions
GetSessionList 6 params → 200400401422
POST
/sessions
Create a New Active Session
createSession body → 200400401404422
GET
/sessions/{session_id}
Retrieve a Session
GetSession 1 param → 200400401404
POST
/sessions/{session_id}/refresh
Refresh a Session
RefreshSession 1 param body → 200400401
POST
/sessions/{session_id}/revoke
Revoke a Session
RevokeSession 1 param → 200400401404
POST
/sessions/{session_id}/tokens
Create a Session Token
CreateSessionToken 1 param body → 200401404
POST
/sessions/{session_id}/tokens/{template_name}
Create a Session Token from a JWT Template
CreateSessionTokenFromTemplate 2 params body → 200401404
DELETE
/v1/client/sessions
Remove Client's Sessions
removeClientSessionsAndRetainCookie → 200401404
GET
/v1/client/sessions/{session_id}
Get Session
getSession 1 param → 200401404
POST
/v1/client/sessions/{session_id}/touch
Touch Session
touchSession 1 param body → 200400401403404422
POST
/v1/client/sessions/{session_id}/end
End Session
endSession 1 param → 200400404
POST
/v1/client/sessions/{session_id}/remove
Remove Session
removeSession 1 param → 200400404
POST
/v1/client/sessions/{session_id}/tokens
Create Session Token
createSessionToken 1 param body → 200401403404
POST
/v1/client/sessions/{session_id}/tokens/{template_name}
Create Session Token with JWT Template
createSessionTokenWithTemplate 2 params → 200401404
POST
/v1/client/sessions/{session_id}/verify
Start a New Session Reverification
startSessionReverification 1 param body → 200401422
POST
/v1/client/sessions/{session_id}/verify/prepare_first_factor
Prepare Session Reverification First Factor
prepareSessionReverificationFirstFactor 2 params body → 200400403422
POST
/v1/client/sessions/{session_id}/verify/attempt_first_factor
Attempt Session Reverification First Factor
attemptSessionReverificationFirstFactor 2 params body → 200400403422
POST
/v1/client/sessions/{session_id}/verify/prepare_second_factor
Prepare Session Reverification Second Factor
prepareSessionReverificationSecondFactor 1 param body → 200400403422
POST
/v1/client/sessions/{session_id}/verify/attempt_second_factor
Attempt Session Reverification Second Factor
attemptSessionReverificationSecondFactor 1 param body → 200400403422

Schemas 51

The contract defines 51 schemas that model the data the API accepts and returns. The most detailed are Client.User (42 properties), Client.SignUp (23 properties), ExternalAccountWithVerification (19 properties), Session (14 properties). Each schema is shown below with its type and property counts.

Session
object
14 properties 10 required
ClerkError
object
4 properties 3 required
ClerkErrors
object
3 properties 1 required
Cookies
object
2 properties 2 required
SessionActivityResponse
objectnull
9 properties 3 required
SessionRefresh
SessionTask
object
1 property 1 required
Token
object
2 properties 2 required
Stubs.Verification.SAML
object
7 properties 2 required
Stubs.Verification.Link
object
6 properties 3 required
Client.Passkey
object
7 properties 4 required
Client.DeleteSession
object
2 properties 2 required
Stubs.SignInFactor
object
11 properties 1 required
Stubs.Verification.BackupCode
object
5 properties 2 required
Client.SessionReverification
object
8 properties 8 required
Stubs.Verification.FromOauth
object
5 properties 2 required
Token_2
object
2 properties 2 required
Stubs.Verification.Admin
object
5 properties 2 required
Client.EmailAddress
object
9 properties 8 required
ExternalAccountWithVerification
object
19 properties 13 required
Client.OrganizationMembership
object
10 properties 9 required
Client.PublicUserData
object
9 properties 4 required
Client.ClientWrappedSessionReverification
object
2 properties 2 required
verification_oauth
object
8 properties 4 required
Stubs.Verification.Ticket
object
5 properties 2 required
schemas-Client.Session
Stubs.Verification.Passkey
object
6 properties 3 required
Client.TouchWrappedSession
object
2 properties 2 required
Stubs.Verification.Web3Signature
object
7 properties 2 required
Client.SessionTask
object
1 property 1 required
schemas-Client.Client
objectnull
11 properties 11 required
Client.ClientWrappedSession
object
2 properties 2 required
Client.User
object
42 properties 35 required
Stubs.Verification.Oauth
object
7 properties 3 required
Client.Organization
object
14 properties 10 required
Stubs.SAMLConnection.SAMLAccount
object
13 properties 7 required
Client.SignUp
object
23 properties 21 required
Client.Web3Wallet
object
6 properties 6 required
schemas-Client.SignIn
object
13 properties 12 required
schemas-Client.SessionBase
object
9 properties 6 required
Client.PhoneNumber
object
11 properties 8 required
Client.SignUp.Verifications
object
4 properties 4 required
Stubs.Verification.Invitation
object
5 properties 2 required
Stubs.Identification.Link
object
2 properties 2 required
verification_google_one_tap
object
7 properties 4 required
Stubs.Verification.TOTP
object
5 properties 2 required
Stubs.Verification.OTP
object
5 properties 3 required
Stubs.Verification.GoogleOneTap
object
5 properties 2 required
Stubs.SignUpVerification.AdditionalFields
object
2 properties 2 required
Stubs.Verification.Password
object
5 properties 2 required
Client.SAMLAccount
object
13 properties 11 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

clerk-com-sessions-api-openapi.yml Raw ↑

Other APIs Clerk publishes across the network.

Clerk Account Portal API
AE Profile APIs.io
Clerk Active Sessions API
AE Profile APIs.io
Clerk Actor Tokens API
AE Profile APIs.io
Clerk Agent Tasks API
AE Profile APIs.io
Clerk Allow-list / Block-list API
AE Profile APIs.io
Clerk API Keys API
AE Profile APIs.io
Clerk Application Transfers API
AE Profile APIs.io
Clerk Applications API
AE Profile APIs.io
Clerk Backup Codes API
AE Profile APIs.io
Clerk Beta Features API
AE Profile APIs.io
Clerk Billing API
AE Profile APIs.io
Clerk Checkouts API
AE Profile APIs.io
#Sessions
← Back to C APIs
API Details
ID
clerk-com:clerk-com-sessions-api
Base URL
https://api.clerk.com/v1
Docs
https://clerk.com/docs/reference/backend-api
Provider
Clerk
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=clerk-com-sessions-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/clerk-com-sessions-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Clerk Sessions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.