⏱️ Scheduler

Scheduler API for AI Agents

Defer a callback, retry on failure, and keep workflows moving.

What it does

Create a one-off scheduled callback for a future time. If delivery fails, the scheduler retries on a fixed cadence and can cascade to the dead letter queue.

Why agents need this

•Agents often need to defer follow-up work until a future time or external event
•Long-running workflows should not require a worker process to stay alive forever
•Deferred callbacks need retries and failure handling, not just a best-effort timeout
•Rolling your own scheduling stack adds infrastructure that the agent does not need

Get started in 30 seconds

One API call. No SDK. No configuration.

cURL

curl -X POST https://www.agent-utils.com/v1/schedules \
  -H "x-agent-id: worker-1" -H "x-api-key: agutil_agt_…" \
  -H "content-type: application/json" \
  -d '{
    "callback_url": "https://your-app.com/hooks/retry",
    "callback_payload": { "job_id": "job_42", "attempt": 1 },
    "fire_at": "2026-07-01T00:00:00Z",
    "dlq_on_failure": true
  }'

Python

import requests

resp = requests.post(
    "https://www.agent-utils.com/v1/schedules",
    headers={
        "x-agent-id": "worker-1",
        "x-api-key": "agutil_agt_…",
        "content-type": "application/json",
    },
    json={
        "callback_url": "https://your-app.com/hooks/retry",
        "callback_payload": {"job_id": "job_42", "attempt": 1},
        "fire_at": "2026-07-01T00:00:00Z",
        "dlq_on_failure": True,
    },
)
schedule_id = resp.json()["data"]["id"]

JavaScript

const res = await fetch("https://www.agent-utils.com/v1/schedules", {
  method: "POST",
  headers: {
    "x-agent-id": "worker-1",
    "x-api-key": "agutil_agt_…",
    "content-type": "application/json",
  },
  body: JSON.stringify({
    callback_url: "https://your-app.com/hooks/retry",
    callback_payload: { job_id: "job_42", attempt: 1 },
    fire_at: "2026-07-01T00:00:00Z",
    dlq_on_failure: true,
  }),
});
const { data } = await res.json();

Use cases

Delayed follow-up

Schedule a reminder or status check after a waiting period without keeping state in memory

Callback handoff

Trigger a webhook at a precise time and continue the workflow later

Retry orchestration

Retry a failed delivery before escalating to a DLQ or manual review

Workflow checkpoints

Wake up a paused agent step when the next action becomes due

AgentUtils vs. alternatives

Traditional tools like AWS EventBridge Scheduler, Cloudflare Cron Triggers, Temporal require SDK integration, credential management, and infrastructure setup. AgentUtils replaces all of that with a single HTTP call.

	AgentUtils	Alternatives
Setup time	30 seconds	Hours to days
SDK required	No (REST API)	Yes
Credentials to manage	1 API key	Multiple keys/tokens
Infrastructure	Zero-config	Provision + configure

Related tools

👤 Human-in-the-Loop

Pause agents until humans approve.

📬 Dead Letter Queue

Catch, inspect, and retry failed agent tasks.

🗃️ KV Store

Tenant-isolated key-value storage with CAS, TTL, and namespaces.

All AgentUtils tools

🗃️ KV Store 📜 Audit Log 📬 Dead Letter Queue 👤 Human-in-the-Loop ⏱️ Scheduler 🖼️ Image Upload

Start building for free

500 free API calls per month. No credit card required.

Get API Key Read Docs