The pagination feature allows you to retrieve a subset of resources from the API. This is useful when you have a large number of resources and you want to retrieve them in smaller chunks.

These list API methods share a common set of parameters that allow you to control the number of items returned and the page number. For example, you can:

​
Parameters

​
page
string
default:"1"

The page number to retrieve. By default, the first page is returned.

​
pageSize
string

The number of items to retrieve per page. The default value varies by endpoint. Maximum value is 100.

​
sortBy
string

The field to sort the results by.

​
sortOrder
string

The order to sort the results by. Can be asc or desc.

​
Example

The following example demonstrates how to retrieve the first page of 10 ingest jobs:

curl --request GET \
  --url https://api.agentset.ai/v1/namespace/{namespace_id}/ingest-jobs?perPage=10 \
  --header 'Authorization: Bearer <token>'