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

https://app.steercoanalytics.com
All endpoints are versioned under /api/v1/.

Authentication

Every request requires a bearer token. See Authentication for how to generate an API key.
curl -H "Authorization: Bearer ak_your_api_key" \
     https://app.steercoanalytics.com/api/v1/workspaces
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:
{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}
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.