ZEzeropath
Agent

Create an agent schedule

Create a recurring assistant schedule. 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. Requires agent management permission. New schedules default to untrusted execution. Repository- or tag-scoped runs always use restricted execution, including when the schedule trusted setting is true.

post/api/v2/agent/createCronSchedule

Request

  • Base URL
    https://zeropath.com
  • Auth
    API key in header X-ZeroPath-API-Token-Id and API key in header X-ZeroPath-API-Token-Secret

Request body

organizationIdstring

Organization ID (injected by MCP server)

namestring required

Unique schedule name.

cronExpressionstring required

Standard 5-field cron expression evaluated in UTC. 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.

promptstring required

The prompt to run each time the schedule fires.

trustedboolean

Whether organization-wide jobs run with trusted tool access. Defaults to false. Repository- or tag-scoped jobs always use restricted execution.

modelStrength'LOW' | 'HIGH'

Model strength copied onto jobs created by this schedule. Omit to use LOW.

repositoryIdsstring[]

Include these repository IDs. Combined with selected tags; omitting both selections creates an organization-wide schedule.

tagIdsstring[]

Include repositories currently carrying any of these tags at each dispatch. An empty resolved selection is rejected.

Response

Schedule created

Changes

No recorded changes to this operation across all 1 revision of this API.