makefx Auth API
Browser sign-in with Google, sessions, and the apps a person has connected.
Browser sign-in with Google, sessions, and the apps a person has connected.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/makefx-app:makefx-app-auth-api"
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.
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: makefx.app Auth API
version: 0.0.0
description: 'Create images, video, and audio with your agent on one canvas. Pay per asset. Every result keeps its recipe.
Reads need an access token with the `read` scope, writes the `write` scope, and routes that manage the account itself accept only the browser session. Tokens come from the OAuth 2.1 authorization server described in `components.securitySchemes`; client registration is open and immediate.
Versioning is by date. The current version is 2026-09-10; send it as `API-Version` to pin a client, omit it for the current version. Every response under /api carries `API-Version` naming the version that answered; an unknown version is refused with 400 `unsupported_version`. A superseded version keeps answering for at least 90 days with `Deprecation` and `Sunset` headers (RFC 9745, RFC 8594) before it is removed.
Rate limits are per 60 seconds: 1200 requests per address for the API, with tighter buckets on the OAuth endpoints. Every response names the policy it passed under in `RateLimit-Policy`; a refusal is 429 with `Retry-After`.
Every error is the `ApiError` shape: an `error` code or sentence, and `error_description` when there is more to say. A request without a valid token answers 401 with a `WWW-Authenticate` header naming the protected resource metadata. Developer documentation: https://makefx.app/developers.'
contact:
name: Aleksei Krasnoperov
url: https://krasnoperov.me
servers:
- url: https://makefx.app
description: makefx.app
tags:
- name: Auth
description: Browser sign-in with Google, sessions, and the apps a person has connected.
paths:
/api/auth/password/register:
post:
operationId: authPasswordRegister
summary: Email account access
description: Register and verify an email account or recover an existing account through an expiring email challenge. Activation precedes sign-in; this endpoint never issues MCP tokens.
tags:
- Auth
requestBody:
content:
application/json:
schema:
type: object
properties:
email:
type: string
maxLength: 320
format: email
password:
type: string
maxLength: 2048
password_confirmation:
type: string
accept_terms:
type: boolean
enum:
- true
redirect:
type: string
maxLength: 2048
required:
- email
- password
- password_confirmation
- accept_terms
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
accepted:
type: boolean
enum:
- true
required:
- accepted
'400':
description: The request did not match the schema
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
parameters:
- $ref: '#/components/parameters/ApiVersion'
/api/auth/password/recover:
post:
operationId: authPasswordRecover
summary: Email account access
description: Register and verify an email account or recover an existing account through an expiring email challenge. Activation precedes sign-in; this endpoint never issues MCP tokens.
tags:
- Auth
requestBody:
content:
application/json:
schema:
type: object
properties:
email:
type: string
maxLength: 320
format: email
redirect:
type: string
maxLength: 2048
required:
- email
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
accepted:
type: boolean
enum:
- true
required:
- accepted
'400':
description: The request did not match the schema
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
parameters:
- $ref: '#/components/parameters/ApiVersion'
/api/auth/password/verify:
post:
operationId: authPasswordVerify
summary: Email account access
description: Register and verify an email account or recover an existing account through an expiring email challenge. Activation precedes sign-in; this endpoint never issues MCP tokens.
tags:
- Auth
requestBody:
content:
application/json:
schema:
type: object
properties:
token:
type: string
pattern: ^[A-Za-z0-9_-]{43}$
password:
type: string
minLength: 1
maxLength: 2048
required:
- token
- password
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
redirect:
type: string
required:
- redirect
'400':
description: The request did not match the schema
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
parameters:
- $ref: '#/components/parameters/ApiVersion'
/api/auth/password/reset:
post:
operationId: authPasswordReset
summary: Email account access
description: Register and verify an email account or recover an existing account through an expiring email challenge. Activation precedes sign-in; this endpoint never issues MCP tokens.
tags:
- Auth
requestBody:
content:
application/json:
schema:
type: object
properties:
token:
type: string
pattern: ^[A-Za-z0-9_-]{43}$
password:
type: string
maxLength: 2048
password_confirmation:
type: string
required:
- token
- password
- password_confirmation
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
redirect:
type: string
required:
- redirect
'400':
description: The request did not match the schema
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
parameters:
- $ref: '#/components/parameters/ApiVersion'
/api/auth/session:
get:
operationId: authSession
summary: Current session
description: The signed-in user of the presented session cookie or bearer token, or null when there is none. Never fails for an anonymous caller.
tags:
- Auth
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
user:
type:
- object
- 'null'
properties:
id:
type: string
email:
type: string
format: email
name:
type: string
required:
- id
- email
- name
config:
type: object
properties:
googleClientId:
type: string
passwordAuthEnabled:
type: boolean
environment:
type: string
required:
- googleClientId
- passwordAuthEnabled
required:
- user
- config
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
parameters:
- $ref: '#/components/parameters/ApiVersion'
/api/auth/password/login:
post:
operationId: authPasswordLogin
summary: Email and password sign-in
description: Starts a browser session for an activated email/password account. MCP access still requires OAuth consent.
tags:
- Auth
requestBody:
content:
application/json:
schema:
type: object
properties:
email:
type: string
minLength: 1
maxLength: 320
password:
type: string
minLength: 1
redirect:
type: string
required:
- email
- password
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
user:
type: object
properties:
id:
type: string
email:
type: string
format: email
name:
type: string
required:
- id
- email
- name
redirect:
type: string
required:
- user
- redirect
'400':
description: The request did not match the schema
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'401':
description: The email or password was not accepted
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: The credential submission was not same-origin
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
parameters:
- $ref: '#/components/parameters/ApiVersion'
/api/auth/google/login:
get:
operationId: authGoogleLogin
summary: Start Google sign-in
description: Redirects the browser to Google. The optional redirect query names the local path to return to afterwards.
tags:
- Auth
parameters:
- schema:
type: string
required: false
name: return_to
in: query
- $ref: '#/components/parameters/ApiVersion'
responses:
'302':
description: Sends the browser to the next step of the flow; there is no body
headers:
Location:
description: Where the browser goes next
schema:
type: string
format: uri
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
/api/auth/logout:
post:
operationId: authLogout
summary: Sign out
description: Ends the current browser session and clears its cookie.
tags:
- Auth
security:
- session: []
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
required:
- success
'401':
description: No valid credentials. WWW-Authenticate names the protected resource metadata to start from
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: 'The credentials are valid but not enough: the token lacks the scope, or the action needs a browser session rather than an app token'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
parameters:
- $ref: '#/components/parameters/ApiVersion'
/api/auth/logout/all:
post:
operationId: authLogoutAll
summary: Sign out everywhere
description: Ends every session of the signed-in user. Accepts a browser session only, never an app token.
tags:
- Auth
security:
- session: []
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
revoked:
type: number
required:
- revoked
'401':
description: No valid credentials. WWW-Authenticate names the protected resource metadata to start from
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: 'The credentials are valid but not enough: the token lacks the scope, or the action needs a browser session rather than an app token'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
parameters:
- $ref: '#/components/parameters/ApiVersion'
/api/auth/grants:
get:
operationId: authGrantsList
summary: List connected apps
description: 'The OAuth grants the signed-in user has given: the client, the scopes, and when each was created and last used. Browser session only.'
tags:
- Auth
security:
- session: []
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
grants:
type: array
items:
type: object
properties:
id:
type: string
clientId:
type: string
clientName:
type: string
scopes:
type: array
items:
type: string
createdAt:
type: number
lastUsedAt:
type: number
expiresAt:
type: number
revokedAt:
type:
- number
- 'null'
required:
- id
- clientId
- clientName
- scopes
- createdAt
- lastUsedAt
- expiresAt
- revokedAt
required:
- grants
'401':
description: No valid credentials. WWW-Authenticate names the protected resource metadata to start from
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: 'The credentials are valid but not enough: the token lacks the scope, or the action needs a browser session rather than an app token'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
parameters:
- $ref: '#/components/parameters/ApiVersion'
delete:
operationId: authGrantsRevokeAll
summary: Revoke all connected apps
description: Revokes every grant of the signed-in user. Browser session only.
tags:
- Auth
security:
- session: []
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
revoked:
type: number
required:
- revoked
'401':
description: No valid credentials. WWW-Authenticate names the protected resource metadata to start from
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: 'The credentials are valid but not enough: the token lacks the scope, or the action needs a browser session rather than an app token'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
parameters:
- $ref: '#/components/parameters/ApiVersion'
/api/auth/grants/{grantId}:
delete:
operationId: authGrantRevoke
summary: Revoke a connected app
description: Revokes one grant. Every token issued under it stops working on its next use. Browser session only.
tags:
- Auth
security:
- session: []
parameters:
- schema:
type: string
description: grantId path parameter
required: true
description: grantId path parameter
name: grantId
in: path
- $ref: '#/components/parameters/ApiVersion'
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
revoked:
type: number
required:
- revoked
'401':
description: No valid credentials. WWW-Authenticate names the protected resource metadata to start from
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: 'The credentials are valid but not enough: the token lacks the scope, or the action needs a browser session rather than an app token'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: Rate limited. RateLimit names the policy; Retry-After says when to try again
headers:
Retry-After:
description: Seconds until the bucket refills
schema:
type: integer
RateLimit:
description: The policy, with nothing left in it
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
components:
parameters:
ApiVersion:
name: API-Version
in: header
required: false
description: The API version the client was written against. Omit it for the current version, 2026-09-10. The response carries the same header, naming the version that answered.
schema:
type: string
enum:
- '2026-09-10'
schemas:
ApiError:
type: object
properties:
error:
type: string
description: A short code or sentence naming what went wrong
error_description:
type: string
description: More for a person, when the code alone would not do
retryable:
type: boolean
description: Whether repeating the same request may succeed
details:
type: object
additionalProperties: {}
description: Machine-readable error context
required:
- error
securitySchemes:
oauth2:
type: oauth2
description: 'OAuth 2.1 authorization code with PKCE (S256), issued by this deployment. Register a client at the registration endpoint or present a Client ID Metadata Document, then send the person to authorize. Metadata: /.well-known/oauth-authorization-server.'
flows:
authorizationCode:
authorizationUrl: https://makefx.app/api/oauth/authorize
tokenUrl: https://makefx.app/api/oauth/token
refreshUrl: https://makefx.app/api/oauth/token
scopes:
openid: Confirm who you are
profile: See your name
email: See your email address
read: Read your data
write: Change your data on your behalf
session:
type: apiKey
in: cookie
name: auth_token
description: The browser session set by signing in with Google. Routes that manage the account itself accept only this, never an app token.
registrationToken:
type: http
scheme: bearer
description: The registration access token returned by client registration (RFC 7592). It manages that one registration and nothing else.
externalDocs:
url: https://makefx.app/developers
description: Developer portal