Skip to main content

​
Authentication

The Steerco API supports two authentication methods:
  • API Keys — simple bearer tokens for scripts and integrations
  • OAuth 2.1 — automatic browser-based auth for MCP tools
API keys are the simplest way to authenticate with the REST API.

​
Generating an API Key

  1. Click your avatar in the top-right corner of the Steerco dashboard
  2. Select Manage Account
  3. Navigate to the API Keys tab
  4. Click Create API Key, give it a name, and copy the key
API keys use the ak_ prefix. Store your key securely — it won’t be shown again.

​
Using Your API Key

Include the API key as a Bearer token in all requests: 
curl -H "Authorization: Bearer ak_your_api_key" \
     https://app.steercoanalytics.com/api/v1/workspaces
API keys are scoped to your user account and have access to all workspaces where the API feature is enabled on the plan.

​
OAuth 2.1 (Used by MCP)

For MCP tools like Claude Desktop and Cursor, authentication happens automatically via OAuth 2.1. You’ll be prompted to sign in via browser on first connection. See the MCP setup guides. The REST API also accepts OAuth tokens if you prefer to use the OAuth flow programmatically: 
# Discover OAuth endpoints
curl https://app.steercoanalytics.com/.well-known/oauth-authorization-server

​
Workspace Selection

Most endpoints require an X-Workspace-Id header. Call the workspaces endpoint first to find your available workspace IDs: 
# 1. List your workspaces
curl -H "Authorization: Bearer ak_your_api_key" \
     https://app.steercoanalytics.com/api/v1/workspaces

# 2. Use a workspace ID in subsequent requests
curl -H "Authorization: Bearer ak_your_api_key" \
     -H "X-Workspace-Id: YOUR_WORKSPACE_ID" \
     https://app.steercoanalytics.com/api/v1/presentations

​
Plan Requirements

API access requires a plan with the API feature enabled. If you receive a 403 response, check your plan in the Steerco dashboard or contact support.