Pagination & limits

Pagination

List endpoints return a consistent envelope and accept limit and cursor query parameters:

{
  "data": [
    /* … items … */
  ],
  "next_cursor": "eyJvIjoxMDB9"
}

• limit — page size, default 50, max 200. Values outside the range are clamped.
• cursor — pass the previous response’s next_cursor to fetch the next page.
• next_cursor is null on the last page.

# First page
curl -s "https://api.halyard-ai.com/api/v1/projects?limit=100" \
  -H "Authorization: Bearer $HALYARD_TOKEN"

# Next page
curl -s "https://api.halyard-ai.com/api/v1/projects?limit=100&cursor=eyJvIjoxMDB9" \
  -H "Authorization: Bearer $HALYARD_TOKEN"

Treat the cursor as opaque — its encoding may change. Always follow next_cursor; don’t construct cursors yourself.

Rate limiting

Requests are limited per token (per minute). Every response carries:

Header	Meaning
RateLimit-Limit	Your per-minute ceiling.
RateLimit-Remaining	Requests left in the current window.
Retry-After	On a 429, seconds to wait before retrying.

When you exceed the limit you get 429 too_many_requests. Back off until Retry-After elapses, then resume. Well-behaved clients watch RateLimit-Remaining and pace themselves before hitting the wall.