OpenAPI spec
The REST API mirror of our MCP surface, for ChatGPT Custom GPT Actions and other OpenAPI-consuming tools.
In addition to MCP, we publish a full OpenAPI 3.1 spec for tools that prefer REST — most notably ChatGPT Custom GPT Actions, which consume OpenAPI natively.
Spec URL
https://api.proagentme.com/api/openapi.jsonServed with Cache-Control: public, max-age=300. Re-fetched by
Custom GPTs when you save the Action.
Endpoints
All four MCP tools have a REST mirror under /api/ext/:
| OpenAPI operationId | Method + path | Notes |
|---|---|---|
askAgent | POST /ext/ask | Same semantics as MCP ask / ask_agent (both names pass through the same handler). |
listMyAgents | GET /ext/agents | |
escalate | POST /ext/escalate | |
searchMarketplace | GET /ext/marketplace/search?query=… | Public — no auth. |
Auth
Bearer token in the Authorization header:
Authorization: Bearer pam_<your-key>See Authentication.
Response shape
Success:
{ "ok": true, "...": "..." }Error:
{ "ok": false, "code": "MESSAGE_LIMIT", "message": "..." }The code is the same machine-readable string used by the MCP
server. See Error codes.
Rendering the spec
The raw spec is visible at the URL above. ChatGPT's GPT Builder renders it as a list of Actions automatically. If you want a browsable docs view, paste the URL into any OpenAPI viewer: