---
title: "List agent schedules"
method: POST
path: "/api/v2/agent/listCronSchedules"
tags: ["Agent"]
---

# List agent schedules

`POST /api/v2/agent/listCronSchedules`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v2/agent/listCronSchedules`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

List configured recurring agent cron schedules for the organization, including their prompt, cron expression, enabled state, repository/tag scope, and schedule IDs. Agent cron schedules run prompts on a recurring time cadence. Use them for polling-style checks, time-window summaries, timeout-rate monitoring, and requests phrased as "every N hours/days" or "on a schedule". For example, create a cron schedule to monitor PR scan timeout rates; do not create a LONG_RUNNING_SCAN event trigger for that recurring workflow. Use this first when you need to find the scheduleId for agent.triggerCronSchedule.

## Request body

- AgentListCronSchedulesRequest
  - `organizationId` string: Organization ID (injected by MCP server)

## Response `200`

List of agent cron schedules

- AgentListCronSchedulesResponse
  - `schedules` object[], required: Configured agent cron schedules. Pass a schedule id to agent.triggerCronSchedule to run one immediately.
    - `id` string, uuid, required: Schedule ID used by agent.triggerCronSchedule.
    - `name` string, required: Human-readable schedule name.
    - `cronExpression` string, required: Cron expression that controls automatic runs. Agent cron schedules run prompts on a recurring time cadence. Use them for polling-style checks, time-window summaries, timeout-rate monitoring, and requests phrased as "every N hours/days" or "on a schedule". For example, create a cron schedule to monitor PR scan timeout rates; do not create a LONG_RUNNING_SCAN event trigger for that recurring workflow.
    - `prompt` string, required: The prompt used when this schedule creates an agent job.
    - `enabled` boolean, required: Whether automatic cron firing is enabled for this schedule.
    - `trusted` boolean, required: Saved Trusted setting. Only applies to organization-wide schedules; inspect effectiveTrusted for actual execution mode.
    - `effectiveTrusted` boolean, required: Actual execution mode. Always false for SELECTED scope.
    - `configurationError` string, nullable, required: Validation error for an existing unsupported cadence. Null means valid; edit an invalid schedule before running it.
    - `scopeMode` 'ALL' | 'SELECTED', required: ALL permits organization-wide execution; SELECTED retains the boundary even if its repositories or tags are deleted.
    - `modelStrength` 'LOW' | 'HIGH', required: Model strength copied onto jobs created by this schedule. LOW is suitable for the vast majority of tasks; HIGH is for unusually complex work.
    - `lastRunAt` string, date-time, nullable, required: Last recorded run time, if available.
    - `nextRunAt` string, date-time, nullable, required: Next automatic run time calculated from the cron expression.
    - `repositories` object[], required: Explicit repositories selected for this schedule, combined with repositories currently carrying any selected tag. Empty selections do not override scopeMode.
      - `id` string, required
      - `name` string, required
    - `tags` object[], required: Tags whose current repositories are included at dispatch. A SELECTED scope with no remaining repositories cannot run.
      - `id` string, required
      - `name` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `401`: Error Response
- `403`: Error Response

---

[API](https://skmtc.dev/zeropath/apis/zeropath-api.md) - [All operations](https://skmtc.dev/zeropath/apis/zeropath-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zeropath/apis/zeropath-api/revisions/126e9c80ba0d?raw)