​
Pagination

When endpoints return large datasets, such as collections, pagination helps manage the response. Use the page and take query parameters to control pagination:

  • page: Specifies the page number to retrieve. Default is 1.
  • take: Specifies the number of records per page. Default is 100.

To retrieve the first 50 collections in an organization, use the following query parameters:

curl --request GET \
 --url 'https://api.withcortex.ai/apps/{app_id}/collections?page=1&take=50'

​
Filtering

Endpoints may support filtering to refine responses. Filtering parameters vary by endpoint. For example, the /collections endpoint supports the following filters:

  • search: Search for a specific term within the response.
  • visibility: Filter collections by visibility status.
  • tags: Filter collections by associated tags.

To search for collections with the term “Debt,” visibility “PUBLIC,” and tags “pending,” use these query parameters:

curl --request GET \
 --url 'https://api.withcortex.ai/apps/{app_id}/collections?search=Debt&visibility=PUBLIC&tags=pending'

Filtering parameters vary by endpoint. Refer to the endpoint documentation for the specific parameters supported.