This endpoint returns the formal OpenAPI 3.1 specification for the public API.
When to use it
Use the OpenAPI document when your tooling expects a standards-based API contract, such as code generation, MCP bridges, or OpenAPI-aware agent frameworks.
Relationship to the lightweight schema
/api/v1/schema remains available as a smaller machine-readable summary. Both documents are generated from the same shared metadata layer.
GET
/api/v1/openapiUse this endpoint with OpenAPI-aware tooling, code generators, MCP bridges, or agent frameworks that expect a standards-based API contract.
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/openapi
Responses
200
Success
Returns the full OpenAPI 3.1 document for the public API.
{
"openapi": "3.1.0",
"info": {
"title": "MadeWithStack Public API",
"version": "1.0.0"
},
"servers": [
{
"url": "https://www.madewithstack.com/api/v1"
}
]
}Operational notes
- Call this when bootstrapping an integration that needs a formal OpenAPI document instead of the lightweight schema summary.
- Use this endpoint for standards-based tooling.
- The lightweight schema remains available at /api/v1/schema.