---
title: "Schedules (5-field cron, UTC) that call an https URL through the secrets proxy or push to a queue. Actions: set, list, history, pause, resume, delete, run_now. Also one-off timers. Free: 1,000 schedules + timers."
method: POST
path: "/api/v1/cron"
tags: ["cron"]
---

# Schedules (5-field cron, UTC) that call an https URL through the secrets proxy or push to a queue. Actions: set, list, history, pause, resume, delete, run_now. Also one-off timers. Free: 1,000 schedules + timers.

`POST /api/v1/cron`

## Request

- Base URL: `https://cloudforbots.com`
- URL: `https://cloudforbots.com/api/v1/cron`
- Auth: HTTP bearer

## Request body

- object
  - `action` 'set' | 'timer' | 'list' | 'history' | 'pause' | 'resume' | 'delete' | 'run_now', required
  - `name` string
  - `schedule` string
  - `request` object
  - `at` string, date-time
  - `delay_s` integer
  - `webhook` string
  - `queue` string
  - `payload` unknown

## Response `200`

ok

---

[API](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api.md) · [All operations](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/revisions/1afdb5648693?raw)