/api/auth/2fa/backup-codesGET /api/auth/2fa/backup-codes

Workspace
Documentation
Loading dashboard…
Browse OpenAPI auth endpoints, key lifecycle runbooks, webhook reliability guidance, and standardized error + rate-limit behavior.
docs/openapi/auth.openapi.json as the contract source of truth.docs/openapi/auth.openapi.json with path + method metadata from the auth contract./api/auth/2fa/backup-codesGET /api/auth/2fa/backup-codes
/api/auth/2fa/backup-codesPOST /api/auth/2fa/backup-codes
/api/auth/2fa/setupGET /api/auth/2fa/setup
/api/auth/2fa/setupPOST /api/auth/2fa/setup
/api/auth/2fa/verifyPOST /api/auth/2fa/verify
/api/auth/2fa/verifyPUT /api/auth/2fa/verify
/api/auth/accountGET /api/auth/account
/api/auth/accountPATCH /api/auth/account
/api/auth/accountDELETE /api/auth/account
/api/auth/account/change-emailPOST /api/auth/account/change-email
/api/auth/account/change-emailPUT /api/auth/account/change-email
/api/auth/account/link-anonymousPOST /api/auth/account/link-anonymous
/api/auth/account/passwordPOST /api/auth/account/password
/api/auth/account/resend-codePOST /api/auth/account/resend-code
/api/auth/account/unlinkPOST /api/auth/account/unlink
/api/auth/anonymousPOST /api/auth/anonymous
/api/auth/bearer-tokenIssue bearer session token
/api/auth/bearer-tokenRevoke bearer session token
/api/auth/change-passwordPOST /api/auth/change-password
/api/auth/docsGET /api/auth/docs
/api/auth/forgot-passwordPOST /api/auth/forgot-password
/api/auth/get-sessionGET /api/auth/get-session
/api/auth/google-one-tap/callbackPOST /api/auth/google-one-tap/callback
/api/auth/magic-linkPOST /api/auth/magic-link
Showing first 24 operations for readability. Use the full JSON contract for generated SDKs and CI validation.
Create key
Name keys by service and environment. Example: mobile-prod-read.
Rotate key
Issue a replacement key, deploy it, verify traffic, then revoke the old key.
Revoke key
Immediately disable compromised keys and review related audit events.
• Validate request signature and timestamp before processing payloads.
• Return 2xx only after persistence succeeds to avoid duplicate side effects.
• Keep handlers idempotent because retries can happen for up to 24 hours.
• Track delivery status and dead-letter retries in your observability stack.
Request preview
curl -X POST https://api.runash.ai/api/auth/sign-in/email \
-H "Authorization: Bearer ***masked***" \
-H "Content-Type: application/json" \
-d '{"email":"dev@runash.ai","password":"***masked***"}'429 Too Many Requests · back off with jitter and retry.
401 Unauthorized · refresh credentials or session token.
403 Forbidden · check scopes for requested operation.
422 Validation Error · inspect payload schema + required fields.
500 Server Error · retry idempotent requests with capped exponential backoff.
503 Service Unavailable · switch to fallback path and alert on-call.