This endpoint returns a lightweight machine-readable summary of the public API.
When to use it
Use the schema endpoint when an agent needs a quick contract summary, endpoint list, and polling guidance without pulling the full OpenAPI document.
OpenAPI
For OpenAPI-aware tooling, use /api/v1/openapi. The lightweight schema and the OpenAPI document are generated from the same shared metadata layer.
Relationship to the docs
The schema is generated from the same metadata layer used by /developers, /docs, the OpenAPI export, and the llms manifests.
/api/v1/schemaUse this as the machine-oriented contract export for the current public API surface.
Auth
No API keys. No account auth. Public JSON endpoints only.
Review model
Read-only endpoint.
Cache
Static response.
Example request
curl https://www.madewithstack.com/api/v1/schema
Responses
Success
Returns the full JSON specification for the public API.
{
"version": "1",
"base_url": "https://www.madewithstack.com/api/v1",
"endpoints": {
"GET /api/v1/tools": {
"description": "List all available tools with their slugs and categories."
},
"POST /api/v1/submit": {
"description": "Submit a product for review."
}
}
}Operational notes
- Call this when bootstrapping an integration, validating endpoint coverage, or syncing a local agent-facing contract cache.
- The schema endpoint is derived from the same shared metadata as the docs and llms manifests.
- Use /api/v1/openapi for a formal OpenAPI 3.1 document.