List schedules
gvt_list_schedulesRead-onlyIdempotent
Retrieves the paginated roster of the authenticated caller's test monitoring schedules, allowing filtering by domain, frequency, and status. This is the only way to discover existing schedules and their schids, which the pause/resume/cancel/change_frequency modes of gvt_schedule_test require. Completed one-off rows are hidden by default: batch runs create a throwaway once row per queued URL, so include them only with includeCompletedOnce true. The row's tid is deliberately not surfaced (it is often stale); use gvt_list_tests or gvt_get_latest for test result lookups. Read-only: consumes rate limit, never test credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | The maximum number of schedules requested for this page. | |
| domain | No | Filter to schedules matching this domain substring. | |
| offset | No | The number of skipped items from the beginning of the result set. | |
| status | No | Filter by the derived overall state of the schedule. | |
| frequency | No | Filter by repetition interval. | |
| sortDirection | No | Sort order by creation time; desc is newest first. | desc |
| includeSubdomains | No | Whether subdomains should be included in the domain filter match. | |
| includeCompletedOnce | No | Whether to include completed one-off schedules in the results. Hidden by default because batch runs create a throwaway once row per queued URL; include them only when investigating batch history. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Page size applied to this response | |
| total | No | Total schedules matching the filters, across all pages | |
| domain | No | The applied domain filter, null when unfiltered | |
| offset | No | Offset applied to this response | |
| status | No | The applied status filter, null when unfiltered | |
| hasMore | No | True when more results exist beyond this page | |
| frequency | No | The applied frequency filter, null when unfiltered | |
| schedules | No | One entry per schedule, newest first by creation time | |
| nextOffset | No | Offset for the next page, null when hasMore is false | |
| includeSubdomains | No | The applied subdomain-inclusion setting | |
| allowedFrequencies | No | Frequencies the caller may set when creating schedules | |
| maxActiveSchedules | No | The caller's cap on active schedules; add mode enforces this limit | |
| includeCompletedOnce | No | Whether completed one-off rows were included in this response |