GeodesicAI Auth API
The Auth API from GeodesicAI — 10 operation(s) for auth.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/geodesiclabs-ai:geodesiclabs-ai-auth-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: GeodesicAI Platform Auth API
version: 3.0.0
tags:
- name: Auth
paths:
/auth/register:
post:
summary: Auth Register
description: 'Create an account and issue a session immediately.
Flow:
1. CAPTCHA (Cloudflare Turnstile) — blocks bot signups.
2. Create user (plan=pilot, awaiting Stripe checkout).
3. Issue session token — user is logged in immediately.
4. Frontend routes them to the plan-selection overlay, which
redirects them to Stripe Checkout to complete sign-up.
Identity verification is handled by Stripe at checkout (real card =
real person); email verification is not required.
Pilot accounts that do not complete Stripe checkout within 30 minutes
are lazily deleted on re-registration or login attempts for the same
email. See AuthManager.PILOT_CHECKOUT_WINDOW_SECONDS.'
operationId: auth_register_auth_register_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RegisterRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Auth
/auth/login:
post:
summary: Auth Login
description: Authenticate and receive a session token.
operationId: auth_login_auth_login_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/LoginRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Auth
/auth/turnstile_sitekey:
get:
summary: Auth Turnstile Sitekey
description: 'Return the Cloudflare Turnstile site key for the signup form.
The site key is public (intended to be embedded in client-side HTML).
If the server isn''t configured with a key, returns an empty string —
the frontend treats that as "CAPTCHA disabled" and skips the widget.'
operationId: auth_turnstile_sitekey_auth_turnstile_sitekey_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
tags:
- Auth
/auth/verify:
get:
summary: Auth Verify
description: 'Verify an email address via the token sent in the welcome email.
On success, redirects the browser to the frontend''s plan-selection page.
This endpoint is public (no auth required) and the token is single-use.'
operationId: auth_verify_auth_verify_get
parameters:
- name: token
in: query
required: false
schema:
type: string
default: ''
title: Token
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Auth
/auth/resend_verification:
post:
summary: Auth Resend Verification
description: Reissue a verification email. Always returns 200 so account existence isn't leaked.
operationId: auth_resend_verification_auth_resend_verification_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ResendVerificationRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Auth
/auth/checkout:
post:
summary: Auth Checkout
description: 'Create a Stripe Checkout Session for a verified, unpaid user.
Returns a URL the frontend should redirect the browser to.
Enterprise tier is handled out-of-band (contact sales).'
operationId: auth_checkout_auth_checkout_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CheckoutRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Auth
/auth/checkout_success:
get:
summary: Auth Checkout Success
description: 'Landing page after a successful Stripe Checkout redirect.
The webhook is the source of truth for plan upgrades; this endpoint just
redirects the user back to the app with a friendly ''check your email'' /
''log in'' message.'
operationId: auth_checkout_success_auth_checkout_success_get
parameters:
- name: session_id
in: query
required: false
schema:
type: string
default: ''
title: Session Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Auth
/auth/logout:
post:
summary: Auth Logout
description: Invalidate a session token.
operationId: auth_logout_auth_logout_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
tags:
- Auth
/auth/me:
get:
summary: Auth Me
description: Get current user info from session token.
operationId: auth_me_auth_me_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
tags:
- Auth
/auth/change_password:
post:
summary: Auth Change Password
description: Change the current user's password. Requires current password.
operationId: auth_change_password_auth_change_password_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ChangePasswordRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Auth
components:
schemas:
LoginRequest:
properties:
email:
type: string
title: Email
password:
type: string
title: Password
type: object
required:
- email
- password
title: LoginRequest
RegisterRequest:
properties:
email:
type: string
title: Email
password:
type: string
title: Password
display_name:
type: string
title: Display Name
default: ''
turnstile_token:
type: string
title: Turnstile Token
default: ''
type: object
required:
- email
- password
title: RegisterRequest
ResendVerificationRequest:
properties:
email:
type: string
title: Email
type: object
required:
- email
title: ResendVerificationRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
CheckoutRequest:
properties:
email:
type: string
title: Email
tier:
type: string
title: Tier
type: object
required:
- email
- tier
title: CheckoutRequest
ChangePasswordRequest:
properties:
current_password:
type: string
title: Current Password
new_password:
type: string
title: New Password
type: object
required:
- current_password
- new_password
title: ChangePasswordRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError