> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getsteerco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Conventions and base URL for the Steerco REST API

# 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](/mcp/overview).

## Base URL

```
https://api.getsteerco.com
```

All endpoints are versioned under `/v1/`.

## Authentication

Every request requires a bearer token. See [Authentication](/authentication) for how to generate an API key.

```bash theme={null}
curl -H "Authorization: Bearer ak_your_api_key" \
     https://api.getsteerco.com/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:

```json theme={null}
{
  "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.