Rate limits & pagination

Rate limits

Requests are limited per API token. The current window is reported on every response:

Header	Description
`X-RateLimit-Limit`	Max requests in the window.
`X-RateLimit-Remaining`	Requests left in the window.
`X-RateLimit-Reset`	Unix epoch when the window resets.

Exceeding the limit returns 429 Too Many Requests. Back off and retry after the reset.

List endpoints are cursor-paginated. Pass limit (max 100) and the next cursor from the previous page:

curl --url "https://api.sysos.app/v1/users?limit=50&cursor=eyJpZCI6..."

{
  "data": [],
  "has_more": true,
  "next_cursor": "eyJpZCI6InVzcl8..."
}