Pagination
How list endpoints page through results.
List endpoints (agents and sources) return page‑based results. Each response includes a meta
block with the page counters and a links block with ready‑to‑use page URLs.
Query parameters
| Parameter | Type | Default | Notes |
|---|---|---|---|
page | integer | 1 | The page to return. Must be ≥ 1. |
per_page | integer | 25 | Items per page. Allowed range 1–100. |
curl "https://api.assistloop.ai/api/public/v1/agents/$AGENT_UUID/sources?page=2&per_page=50" \
-H "Authorization: Bearer $ASSISTLOOP_API_KEY"Response shape
{
"data": [ /* ... resources ... */ ],
"meta": {
"current_page": 2,
"per_page": 50,
"total": 120,
"last_page": 3,
"request_id": "b7f0b9c2-1a2b-4c3d-8e9f-0a1b2c3d4e5f"
},
"links": {
"first": "https://api.assistloop.ai/api/public/v1/agents/.../sources?page=1",
"last": "https://api.assistloop.ai/api/public/v1/agents/.../sources?page=3",
"prev": "https://api.assistloop.ai/api/public/v1/agents/.../sources?page=1",
"next": "https://api.assistloop.ai/api/public/v1/agents/.../sources?page=3"
}
}| Field | Description |
|---|---|
meta.current_page | The page number you are viewing. |
meta.per_page | Items per page actually applied (after the 100 cap). |
meta.total | Total number of items across all pages. |
meta.last_page | The number of the last page. |
links.next | URL of the next page, or null on the last page. |
Pagination links don't carry filters
The generated links contain only the page parameter (e.g. ?page=3). They do not include
per_page or any filters (status, type, id). When walking pages, re-send per_page and your
filters on every request — otherwise the next page falls back to the defaults (per_page=25, no
filter).