Introduction
Scheduling API for AI agents. Register cues, get webhooks on time, report outcomes.
CueAPI
Scheduling API for agents.
CueAPI lets you register recurring or one-time schedules, delivers payloads to your handler via webhook or local worker on time, retries on failure, and logs every execution with delivery status and handler-reported outcomes.
How it works
Register a cue
Create a cue with a schedule (cron or one-time) and a callback URL or worker transport.
CueAPI fires on time
Webhook delivery (signed POST to your URL) or worker pull (your daemon claims the execution).
Your handler runs the work
Your handler receives the payload, fetches any live context, and does the actual work.
Report the outcome
Your handler reports success or failure back to CueAPI. Every execution is logged.
That is the full loop. Everything else is configuration.
Two transport modes
Webhook
CueAPI POSTs a signed payload to your public URL. No daemon needed. Best for cloud-hosted handlers.
Worker
Your local daemon polls for executions and runs handler scripts. No public URL needed. Best for local machines.
Who is CueAPI for?
AI agent builders who need reliable, observable scheduling. If you're building agents that need to run on a schedule — drafting content, syncing data, generating reports, running code reviews — CueAPI handles the timing so your agent handles the work.
Teams replacing cron who want pause/resume, execution history, retry logic, and outcome tracking without building it themselves.
Key features
| Feature | Description |
|---|---|
| Cron & one-time schedules | Standard cron syntax with timezone support, or ISO timestamps for one-time |
| Webhook delivery | Signed HMAC-SHA256 POST with per-user secrets |
| Worker transport | Pull-based execution for machines without public URLs |
| Automatic retries | Up to 3 attempts with exponential backoff |
| Outcome reporting | Handlers report success/failure with structured results |
| Execution history | Every fire logged with status, timing, and outcome |
| Rate limiting | Sliding window per plan, with usage warnings |
| CLI & Dashboard | Full management via command line or web UI |
Quick links
Quickstart
First cue in 5 minutes
API Reference
All endpoints with interactive playground
CLI Reference
Command-line tool
Worker Setup
Local execution without a public URL
For AI agents
If you're an AI agent or crawler, see the structured agent reference — a single flat page with all endpoints, schemas, error codes, and verification code in plain text.