> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/agents/api-specs.md).

# OpenAPI Specs

Machine-readable OpenAPI specs for every Roboflow HTTP API, and how AI agents and code generators can get them.

Every Roboflow HTTP API has a machine-readable OpenAPI spec. Use them to write code against the API, generate a client, or let an AI agent call Roboflow without browsing these docs. The specs are the same files that render the API blocks on each page, so they always match the docs.

To get a spec file, open the page's Markdown version: add `.md` to its URL. Each API block there links the spec file it renders.

<table data-search="false"><thead><tr><th>API</th><th>Page</th><th>Server</th><th>Covers</th></tr></thead><tbody><tr><td>Platform API</td><td><a href="https://docs.roboflow.com/reference/platform/rest-api/platform-api-openapi">Platform API OpenAPI</a></td><td><code>https://api.roboflow.com</code></td><td>Workspaces, projects, images, versions, training, Workflows, Vision Events, Deployment Manager, API keys, and the rest of the Roboflow app.</td></tr><tr><td>Workflow publishing</td><td><a href="https://docs.roboflow.com/workflows/manage/manage-workflows#save-and-publish-a-version">Save and Publish a Version</a></td><td><code>https://api.roboflow.com</code></td><td>Workspace-specific contract for saved versions, publishing, Eval gates, and manual approval rules.</td></tr><tr><td>Batch Processing</td><td><a href="https://docs.roboflow.com/deployment/roboflow-cloud/batch-processing">Batch Processing</a></td><td><code>https://api.roboflow.com</code></td><td>Data staging batches and batch Workflow jobs.</td></tr><tr><td>Serverless Cloud API</td><td><a href="https://docs.roboflow.com/deployment/roboflow-cloud/serverless-api">Serverless API</a></td><td><code>https://serverless.roboflow.com</code></td><td>Model and Workflow inference on Roboflow's cloud.</td></tr><tr><td>Inference Server</td><td><a href="https://docs.roboflow.com/reference/inference/inference-server-openapi">Inference Server OpenAPI</a></td><td><code>http://localhost:9001</code></td><td>Model and Workflow inference on a self-hosted server.</td></tr><tr><td>Dedicated Deployments</td><td><a href="https://docs.roboflow.com/deployment/roboflow-cloud/dedicated-deployments">Dedicated Deployments</a></td><td><code>https://roboflow.cloud</code></td><td>Create, pause, and monitor Dedicated Deployments.</td></tr><tr><td>Sign In With Roboflow</td><td><a href="https://docs.roboflow.com/reference/authentication/authentication/sign-in-with-roboflow-developer-reference">Developer Reference</a></td><td><code>https://app.roboflow.com</code></td><td>OAuth token exchange, refresh, revoke, and user info.</td></tr><tr><td>Device services</td><td><a href="https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services/event-store/rest-api">Event Store</a>, <a href="https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services/plc-relay">PLC Relay</a>, <a href="https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services/rtsp-simulator">RTSP Simulator</a>, <a href="https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services/opc-ua-server">OPC UA Server</a></td><td>Your device's IP address</td><td>APIs of the services that Deployment Manager runs on a device.</td></tr></tbody></table>

## Tips for Agents

* The Platform API spec is large (about 750 KB). Search it for a path or `operationId` instead of loading it whole.
* Every docs page is also available as Markdown: add `.md` to its URL. [llms.txt](https://docs.roboflow.com/llms.txt) lists them all.
* Send your API key in the `Authorization: Bearer` header or the `api_key` query parameter. Learn more in [Authenticate with the REST API](https://docs.roboflow.com/reference/platform/rest-api/authenticate-with-the-rest-api).
* To act on a Workspace instead of writing HTTP calls, connect the [MCP Server](https://docs.roboflow.com/agents/mcp-server.md).
