> This page is for version API + Legacy Full.
> For other versions, use one of these documentation indexes:
> - API (default): https://docs.getthera.com/api/llms.txt
> - API + Legacy Read: https://docs.getthera.com/api-legacy-read/llms.txt
> - API + Legacy Full: https://docs.getthera.com/api-legacy-full/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.getthera.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.getthera.com/_mcp/server.

# Welcome

Read-only access to your company's data in Thera. Keys call `GET` endpoints. Anything that
writes is refused.

## Get a key

You can create an api key from the `Settings` page in the Thera app. Navigate to `/account-preferences/api-keys`. A key belongs to one company and reads only that company's data.

> Note: If you have keys issued before self-serve, they still work and appear there as legacy keys but we recommend to migrate them to new keys.

## Authenticate

Send the key as `X-Thera-API-Key` in the request header of api call.

```bash
curl https://api.getthera.com/companies/{companyId}/teams \
  -H "X-Thera-API-Key: <your key>"
```

Most endpoints take a `companyId`. Ask Thera support if you are not able to find your company ID.

## Rate limit

600 requests a minute. Past that you get a `429` with the wait time.

That one and every other error is described on the [Errors](/errors) page.