> ## Documentation Index
> Fetch the complete documentation index at: https://oma-codex-339-workspace-permissions.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> Traverse OMA list resources with page cursors.

OMA list endpoints generally use opaque cursor pagination.

## Request parameters

<ParamField query="limit" type="integer">
  Maximum objects returned on this page. Defaults and limits vary by resource.
</ParamField>

<ParamField query="page" type="string">
  The `next_page` value from the previous response. Do not parse or modify it.
</ParamField>

## Response shape

```json theme={null}
{
  "data": [
    {"id": "agent_...", "type": "agent"}
  ],
  "next_page": "opaque-cursor"
}
```

A `null` or absent `next_page` means there is no next page.

## Traversal example

```bash theme={null}
curl 'http://localhost:38080/v1/agents?beta=true&limit=20' \
  -H 'Authorization: Bearer sk-ant-local-default'

curl 'http://localhost:38080/v1/agents?beta=true&limit=20&page=<next_page>' \
  -H 'Authorization: Bearer sk-ant-local-default'
```

<Note>
  A cursor has no stable public relationship to a creation time, resource ID, or database key. Always store and return it as an opaque string.
</Note>

Filters vary by resource and can include `created_at[gte]`, `status`, `agent_id`, or `include_archived`. Unknown or invalid filter values return an `invalid_request_error`.