Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt

Use this file to discover all available pages before exploring further.

API keys

All endpoints (except /v1/health and webhooks) require a Bearer token.
curl -H "Authorization: Bearer rw_live_..." \
  https://api.rewind.rest/v1/listening/recent

Key types

Key typePrefixAccess
Readrw_live_...All GET endpoints
Adminrw_admin_...All endpoints including sync triggers, data management, and key management
Read keys are safe to use in client-side applications. Admin keys should only be used server-side.

Rate limiting

The API uses a sliding window rate limiter per API key:
  • Window: 60 seconds
  • Limit: 100 requests per window
When rate limited, the API returns 429 Too Many Requests.

Unauthorized responses

If your key is missing or invalid:
{
  "error": "Unauthorized",
  "status": 401
}