---
title: "Run an agent schedule now"
method: POST
path: "/api/v2/agent/triggerCronSchedule"
tags: ["Agent"]
---

# Run an agent schedule now

`POST /api/v2/agent/triggerCronSchedule`

## Request

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

Manually queue an immediate run of an existing agent cron schedule, matching the dashboard "Run now" action. This creates a CRON agent job using the schedule prompt, trust setting, model strength, Slack channel, and scope. It does not change the schedule cron expression or automatic run cadence.

## Request body

- AgentTriggerCronScheduleRequest
  - `organizationId` string: Organization ID (injected by MCP server)
  - `scheduleId` string, uuid, required: Schedule ID from agent.listCronSchedules.

## Response `200`

Schedule run queued

- AgentTriggerCronScheduleResponse
  - `jobId` string, uuid, required: Queued agent job ID. Use agent.getJob with this ID to inspect status and results.
  - `conversationId` string, uuid, required: Conversation created for this manual schedule run.
  - `scheduleId` string, uuid, required: Triggered schedule ID.
  - `scheduleName` string, required: Triggered schedule name.

## Other responses

- `400`: Error Response
- `401`: Error Response
- `403`: Error Response
- `404`: Error Response
- `412`: 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)