Search Incidents
search_incidentsRead-only
Search Rootly incidents by title or summary and control pagination to fetch all matching results or a specific page.
Instructions
Search incidents with flexible pagination control.
Use page_number=0 to fetch all matching results across multiple pages. Use page_number>0 to fetch a specific page.
max_results (also accepted as limit) caps how many incidents come back
in either mode: across pages when page_number=0, and within the page
otherwise. Left unset, a single page returns page_size incidents and
page_number=0 stops at 5.
Argument caps: page_size <= 20, max_results <= 10. Values outside those bounds are clamped and reported, not rejected.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Search query to filter incidents by title/summary | |
| page_size | No | Number of results per page (max: 20) | |
| max_results | No | Maximum incidents to return. Max: 10; defaults to 5 when fetching all pages, and to page_size when fetching a single page. For larger result sets, paginate with page_number > 0 or use collect_incidents. | |
| page_number | No | Page number to retrieve (use 0 for all pages) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||