---
title: cronRun
description: Gateway RPC for triggering cron schedules.
maturity: stable
apiVersion: v1
---

`cronRun` triggers a cron schedule or workflow immediately. Pass either `cronId` to trigger an existing schedule, or `workflow` to trigger a workflow directly (at least one is required).

- Method: `cronRun`
- Scope: `cron:write`
- Transports: HTTP RPC, WebSocket RPC
- Request: `{ cronId?, workflow?, input? }`
- Response: `{ runId, workflow }`

Errors are versioned as `v1` and include `InvalidRequest`, `InvalidInput`, `Unauthorized`, `Forbidden`, `CronNotFound`, and `Internal`.
