Skip to main content
GET
/
v1
/
openapi.json
OpenAPI Spec
curl --request GET \
  --url https://api.bctrl.ai/v1/openapi.json \
  --header 'Authorization: Bearer <token>'
{
  "openapi": "<string>",
  "info": {
    "title": "<string>",
    "version": "<string>"
  },
  "paths": {}
}
The response is cached for 60 seconds. The spec includes all public API paths with request/response schemas.

​
Examples

const response = await fetch('https://api.bctrl.ai/v1/openapi.json', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const spec = await response.json();
console.log(Object.keys(spec.paths).length, 'endpoints');

​
Response

​
openapi
string
required
OpenAPI version (3.0.3).
​
info
object
required
API metadata.
​
paths
object
required
All API path definitions.
Response Example
{
  "openapi": "3.0.3",
  "info": {
    "title": "bctrl API",
    "version": "2026-02-16"
  },
  "paths": {
    "/v1/sessions": {
      "post": {
        "summary": "Create a new session"
      }
    },
    "/v1/sessions/{id}/automation": {
      "post": {
        "summary": "Execute automation command"
      }
    }
  }
}