---
title: "Trigger cron job run"
method: POST
path: "/cron-jobs/{cronJobId}/runs"
tags: ["Services - Cron Jobs"]
---

# Trigger cron job run

`POST /cron-jobs/{cronJobId}/runs`

Trigger a run for a cron job and cancel any active runs.

## Response `200`

OK

- CronJobRun — A run of a cron job
  - `id` string, required — The ID of the run
  - `status` 'pending' | 'successful' | 'unsuccessful' | 'canceled', required
  - `startedAt` string, date-time
  - `finishedAt` string, date-time
  - `triggeredBy` string — user who triggered the cron job run
  - `canceledBy` string — user who cancelled the cron job run

## Other responses

- `401` — Authorization information is missing or invalid.
- `406` — Unable to generate preferred media types as specified by Accept request header.
- `429` — Rate limit has been surpassed.
- `500` — An unexpected server error has occurred.
- `503` — Server currently unavailable.

---

[API](https://skmtc.dev/render/apis/render-public-api.md) · [All operations](https://skmtc.dev/render/apis/render-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/render/render-public-api/revisions/80e0ff74d033/schema)