Skip to main content

API Reference

The Steerco REST API exposes HTTP endpoints for managing presentations, templates, themes, and entities. All endpoints return JSON and share the same authentication model as the MCP server.

Base URL

All endpoints are versioned under /v1/.

Authentication

Every request requires a bearer token. See Authentication for how to generate an API key.
Most endpoints also require an X-Workspace-Id header. List your workspaces first to get a valid ID.

Response Format

Successful responses return JSON with a 200 or 201 status. Errors return a JSON body with error and message fields:
Common status codes:
  • 400 — malformed request (check your payload)
  • 401 — missing or invalid auth token
  • 403 — plan does not include API access, or insufficient permissions
  • 404 — resource not found or not accessible in this workspace
  • 429 — rate limit exceeded

Endpoints

The full list of endpoints is grouped in the sidebar. Start with the workspaces endpoint to find your workspace ID, then explore presentations, templates, and entities from there.