API reference

Create a read-only token

In Console → Developer, choose a name, a lifetime of 1–90 days and the permissions you need. The full token appears once. Up to 10 active tokens are allowed. Pass secrets through secure environment variables, never commit them or paste them into prompts.

Read activities

GET /v1/developer/activities?limit=25
Authorization: Bearer YOUR_PERSONAL_TOKEN

Response:

{"schema_version":1,"items":[],"total":0,"next_offset":null}

Parameters include q for title search, from/to dates, offset and limit. See Formats & units for fields.

Export

GET /v1/developer/export?format=csv
Authorization: Bearer YOUR_PERSONAL_TOKEN

Requires data:export. Export does not accept offset or limit. More than 10,000 activities returns 413; split by date range.

Errors and rate limits

401 means invalid, expired or revoked credentials; 403 means insufficient scope; 400 means invalid parameters; 429 means the token's 60-request-per-minute window is exhausted; 503 means temporary storage or service failure. Never retry 401/403 indefinitely. Wait at least a minute after 429 and use bounded backoff for 503.

Machine-readable entry points

Use OpenAPI 3.1, llms.txt, or copy Markdown from any documentation page. Automation tools and AI agents use the same read-only tokens and scopes.