Reference
Exact backend contracts live in the API reference.
This page explains where to find the source-of-truth contracts and how the public mock runtime URL shape maps to generated project endpoints.
Entry points
Reference surfaces
Use the interactive backend reference for exact schemas. Use this page for orientation.
- Interactive API docs
- Use the backend Scalar route for exact request and response contracts.
- OpenAPI JSON
- Download the backend OpenAPI document for generated clients or inspection.
- Mock runtime
- Generated mock endpoints live under /mock/{projectId}/{path}.
- Authenticated project APIs
- Project, schema, settings, member, and log routes require an authenticated GhostAPI session.
Route map
Backend families
The application API is grouped by product capability rather than raw database tables.
- Auth
- Register, login, refresh, logout, CSRF, password reset, verification, and invitation acceptance.
- Projects
- Create, read, update, delete, configure, and list project-owned resources.
- Schemas
- Upload, validate, replace, version, and inspect OpenAPI schemas.
- Members
- Invite users, preview recipients, accept invitations, and manage project roles.
- Mock runtime
- Serve generated routes, saved responses, generated responses, request logs, and runtime behavior.
Example
Mock runtime URL
Project mock routes are normal HTTP URLs and can be called by frontend code or cURL.
Mock route
curl "http://localhost:3001/mock/{projectId}/users/42" \
-H "authorization: Bearer dev-token"