Skip to main content
403 Forbidden

Error types

Rate limits

Each brand gets 60 calls a minute and 10,000 a day, shared by all its keys. MCP tool calls count the same as API calls. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset headers. A 429 also carries Retry-After.

Retries

Every version 1 call is a GET, so it’s always safe to retry.
  • Retry a 429 after Retry-After.
  • Retry a 500 or 503 with exponential backoff: 1s, 2s, 4s, at most 5 tries.
  • Don’t retry other 4xx errors. Fix the request instead.
Every response carries an X-Request-Id header. Quote it when you contact us.

Pagination

List endpoints return 25 items by default, and up to 100 with limit. When has_more is true, pass next_cursor as cursor to get the next page.