Traverse list endpoints with opaque cursors.
List endpoints return one page at a time. Use limit to control the page size and after to continue from the cursor returned by the previous response.
| Parameter | Type | Description |
|---|---|---|
limit | integer | Number of objects to return. Defaults to 20 and is capped at 100. |
after | string | Opaque cursor from the previous page's next_cursor. |
The first request does not need an after value:
curl "https://api.heroui.pro/v1/conversations?limit=100" \
--header "Authorization: Bearer $HEROUI_AGENT_API_KEY"Every list endpoint returns the same envelope:
{
"object": "list",
"data": [],
"has_more": true,
"next_cursor": "opaque_cursor"
}data contains the resources in the current page.has_more indicates whether another page is available.next_cursor is the value to send as after on the next request. It is null on the final page.curl "https://api.heroui.pro/v1/conversations?limit=100&after=opaque_cursor" \
--header "Authorization: Bearer $HEROUI_AGENT_API_KEY"Continue until has_more is false. Treat cursors as opaque values: do not parse them, modify them, or use a resource ID in their place.