Clerk

Clerk Sign Ins API

Used to sign in a user in the current client.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 9

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

POST /v1/client/sign_ins Start a sign-in on the current client · Create a New Sign in or Replace the Current One #
Ask an LLM
“How do I start signing a user in with their email or username?”
“Can I identify and verify a sign-in in one request using a password?”
Tell an agent
Start a sign-in for {identifier} with the {strategy} strategy.
Sign in {identifier} using password {password}.
GET /v1/client/sign_ins/{sign_in_id} Retrieve a sign-in attempt · Retrieve Sign-in #
Ask an LLM
“What status is my in-progress sign-in attempt in?”
“Can I check whether a sign-in still needs a second factor?”
Tell an agent
Get sign-in attempt {sign_in_id}.
Show the current status of sign-in {sign_in_id}.
POST /v1/client/sign_ins/{sign_in_id}/reset_password Reset the password during sign-in · Reset Password on Sign-in #
Ask an LLM
“How does a user set a new password while signing in after a reset code?”
“Can resetting the password also sign the user out of their other sessions?”
Tell an agent
Reset the password on sign-in {sign_in_id} to {password}.
Set new password {password} for sign-in {sign_in_id} and end other sessions.
POST /v1/client/sign_ins/{sign_in_id}/prepare_first_factor Send the first-factor code or link for a sign-in · Prepare First Factor Verification #
Ask an LLM
“How do I send a one-time code to the user's email or phone during sign-in?”
“Can the first sign-in step use a passkey or an email link instead of a code?”
Tell an agent
Send a first-factor code for sign-in {sign_in_id} using {strategy}.
Prepare first-factor {strategy} for sign-in {sign_in_id} to email {email_address_id}.
POST /v1/client/sign_ins/{sign_in_id}/attempt_first_factor Submit the first-factor code or password · Attempt First Factor Verification #
Ask an LLM
“How do I complete the first sign-in step with the code the user received?”
“Can a user pass the first factor with just their password?”
Tell an agent
Attempt first factor on sign-in {sign_in_id} with {strategy} code {code}.
Verify sign-in {sign_in_id} with {strategy} and password {password}.
POST /v1/client/sign_ins/{sign_in_id}/prepare_second_factor Send the second-factor code for a sign-in · Prepare Second Factor Verification #
Ask an LLM
“How do I send an MFA code by SMS once a sign-in needs a second factor?”
“What starts the two-factor step for a sign-in that says needs_second_factor?”
Tell an agent
Send a second-factor code for sign-in {sign_in_id} to phone {phone_number_id}.
Prepare the MFA step for sign-in {sign_in_id} using {strategy}.
POST /v1/client/sign_ins/{sign_in_id}/attempt_second_factor Submit the second-factor code · Attempt Second Factor Verification #
Ask an LLM
“How do I finish two-factor sign-in with the user's TOTP or SMS code?”
“Which strategy do I pass along with the code to clear the second factor?”
Tell an agent
Complete MFA on sign-in {sign_in_id} with code {code}.
Attempt second factor {strategy} for sign-in {sign_in_id} using {code}.
GET /v1/tickets/accept Accept a ticket link such as an invitation · Accept Ticket #
Ask an LLM
“What happens when a user clicks a ticket link from an invitation email?”
“How is a ticket JWT turned into a redirect with the ticket attached?”
Tell an agent
Accept ticket {ticket}.
Process the invitation ticket {ticket} and follow its redirect.
GET /v1/verify Complete an email link verification · Attempt Email Link Verification #
Ask an LLM
“How is an email magic link verified when the user clicks it?”
“What does the email link token get checked against?”
Tell an agent
Verify the email link with token {token}.
Complete magic link verification for token {token}.

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-sign-ins-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-sign-ins-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-sign-ins-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clerk Frontend Sign Ins API
  version: v1
  description: The Clerk REST Frontend API, meant to be accessed from a browser or native environment.
  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 Team
    url: https://clerk.com/support
  termsOfService: https://clerk.com/terms
  license:
    name: MIT
    url: https://github.com/clerk/javascript/blob/main/LICENSE
servers:
- url: https://{domain}.clerk.accounts.dev
  variables:
    domain:
      default: example-destined-camel-13
      description: Your Development Instance Frontend API Domain.
security:
- {}
- DevBrowser: []
- ProductionBrowser: []
- ProductionNativeApp: []
  ProductionNativeFlag: []
tags:


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