makefx Service API
The API index and health checks. Nothing here needs a token.
The API index and health checks. Nothing here needs a token.
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-service-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 Service 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: Service
description: The API index and health checks. Nothing here needs a token.
paths:
/api:
get:
operationId: apiIndex
summary: API index
description: Where this deployment's OpenAPI document, developer documentation, authorization metadata, MCP endpoint and health check are, as absolute URLs. Needs no token.
tags:
- Service
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
name:
type: string
version:
type: string
description:
type: string
openapi:
type: string
format: uri
documentation:
type: string
format: uri
health:
type: string
format: uri
mcp:
type: object
properties:
endpoint:
type: string
format: uri
serverCard:
type: string
format: uri
required:
- endpoint
- serverCard
authorization:
type: object
properties:
authorizationServer:
type: string
format: uri
protectedResource:
type: string
format: uri
required:
- authorizationServer
- protectedResource
catalog:
type: string
format: uri
llms:
type: string
format: uri
required:
- name
- version
- description
- openapi
- documentation
- health
- mcp
- authorization
- catalog
- llms
'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/health:
get:
operationId: healthCheck
summary: Health check
description: Reports that the service is reachable and which environment answered. Needs no token.
tags:
- Service
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
status:
type: string
environment:
type: string
required:
- status
'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/hello:
get:
operationId: hello
summary: Hello
description: A fixed greeting that proves the API foundation is wired. Needs no token.
tags:
- Service
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
message:
type: string
required:
- message
'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'
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