# codai Schedules API

**Canonical:** https://apis.io/apis/codai-ro/codai-ro-schedules-api/  
**Provider:** codai — https://apis.io/providers/codai-ro/  
**Base URL:** https://ai.codai.ro  
**Documentation:** https://docs.codai.ro/docs/api

codai Schedules API is one of 35 APIs that [codai](https://apis.io/providers/codai-ro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Schedule. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

codai Scheduler: scheduled agent tasks, terminal commands, webhooks and chains that run on any of your hosts (PCs, phones, watch, cloud VMs) or in the cloud. The cloud owns every schedule; hosts claim runs with a lease and report results. Shell commands run only after the host approved the exact command.

## Operations (26)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/schedules/pause` | Pause all schedules |
| POST | `/v1/schedules/resume` | Resume schedules |
| GET | `/v1/schedules/templates` | List schedule templates |
| POST | `/v1/schedules/templates` | Render a template |
| GET | `/v1/heartbeats` | List heartbeat monitors |
| POST | `/v1/heartbeats` | Create a heartbeat monitor |
| PATCH | `/v1/heartbeats/{id}` | Update a heartbeat monitor |
| DELETE | `/v1/heartbeats/{id}` | Delete a heartbeat monitor |
| GET | `/v1/schedules` | List schedules |
| POST | `/v1/schedules` | Create a schedule |
| POST | `/v1/schedules/preview` | Preview a trigger |
| GET | `/v1/schedules/audit` | Scheduler audit log |
| GET | `/v1/schedules/stream` | Stream scheduler events |
| GET | `/v1/schedules/{id}` | Get a schedule |
| PATCH | `/v1/schedules/{id}` | Update a schedule |
| DELETE | `/v1/schedules/{id}` | Delete a schedule |
| POST | `/v1/schedules/{id}/run` | Run now |
| GET | `/v1/schedules/{id}/runs` | List runs of a schedule |
| POST | `/v1/schedules/{id}/approve-command` | Approve a shell command on this host |
| GET | `/v1/schedule-runs` | List recent runs |
| POST | `/v1/schedule-runs/{id}/decision` | Approve or skip a run |
| POST | `/v1/schedule-runs/{id}/heartbeat` | Run heartbeat |
| POST | `/v1/schedule-runs/{id}/result` | Report a run result |
| GET | `/v1/scheduler/hosts` | List scheduler hosts |
| PATCH | `/v1/scheduler/hosts/{id}` | Update a host |
| POST | `/v1/scheduler/claim` | Claim the next run |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/codai-ro/openapi/codai-ro-schedules-api-openapi.yml
- **Documentation** — https://docs.codai.ro/docs/gateway
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-schedule-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-schedule-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-schedule-audit-entry-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-schedule-run-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-heartbeat-monitor-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-scheduler-host-schema.json

## Other codai APIs (12)

- [codai Account API](https://apis.io/apis/codai-ro/codai-ro-account-api/)
- [codai Agents API](https://apis.io/apis/codai-ro/codai-ro-agents-api/)
- [codai Attestations API](https://apis.io/apis/codai-ro/codai-ro-attestations-api/)
- [codai Authorization API](https://apis.io/apis/codai-ro/codai-ro-authorization-api/)
- [codai Chat & Completions API](https://apis.io/apis/codai-ro/codai-ro-chat-completions-api/)
- [codai Connect API](https://apis.io/apis/codai-ro/codai-ro-connect-api/)
- [codai Devices API](https://apis.io/apis/codai-ro/codai-ro-devices-api/)
- [codai Discovery API](https://apis.io/apis/codai-ro/codai-ro-discovery-api/)
- [codai Embeddings & Audio API](https://apis.io/apis/codai-ro/codai-ro-embeddings-audio-api/)
- [codai Feed API](https://apis.io/apis/codai-ro/codai-ro-feed-api/)
- [codai Guest chat API](https://apis.io/apis/codai-ro/codai-ro-guest-chat-api/)
- [codai Health API](https://apis.io/apis/codai-ro/codai-ro-health-api/)

## Tags

Schedule

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/codai-ro/codai-ro-schedules-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/codai-ro/.
