Authentication
The Menutes API uses API key authentication via theAuthorization header.
Creating an API Key
- Go to Settings → API Keys in Menutes
- Click Create key and give it a name (e.g., “Claude Code”)
- Copy the key immediately — it will only be shown once
mnts_ followed by 40 hex characters:
Using the API Key
Include the key in every request as a Bearer token:Scopes
API keys currently support theread scope, which grants read-only access to:
- Your own recordings
- Recordings shared with you (team/organization scope)
Security
- API keys are hashed before storage — Menutes never stores the raw key
- Keys can be revoked at any time from Settings
- Optional expiration date can be set at creation time
- Keys respect the same sharing scopes (Private, Team, Organization) as the web app
- Rate limit: 1,000 requests per hour per user
Rate Limiting
When rate limited, the API returns HTTP429 with these headers:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests per window |
X-RateLimit-Remaining | Remaining requests in current window |
X-RateLimit-Reset | When the window resets (ISO 8601) |
Retry-After | Seconds until you can retry |