Pagination

Most list tools accept page and per_page arguments.

ArgumentDefaultMaximum
page1—
per_page50100

Responses include _pagination with totals and a next object when another page exists:

{
  "_pagination": {
    "page": 1,
    "per_page": 50,
    "total": 120,
    "total_pages": 3,
    "next": {
      "tool": "list_applications",
      "args": { "page": 2, "per_page": 50 }
    }
  }
}

Call next.tool with the returned next.args values rather than assuming page size or total pages. next.args also repeats the filters of the first call.

Exceptions:

  • list_unhealthy_resources uses a default per_page of 20.
  • search_resources has no pages. Use limit: default 25, maximum 50.
  • These tools return all results without pages: list_env_keys, list_shared_env_keys, list_storages, list_resource_tags, list_scheduled_tasks, list_database_backups, list_service_applications, list_service_databases, list_github_repositories, list_github_branches.

On this page