agent-wake

schedule wake

Schedule a wake-up for your agent. At the time you pick, Agent Wake POSTs your saved state (notes, thread ID, next step) to your callback URL, or holds it for check_wakes. Use it so a later, fresh session picks up where this one stopped. Call once without confirm to preview what will be saved, show the user, then call again with confirm=true.

post/api/v1/agent-wake/schedule_wake

Request

  • Base URL: https://cloudforbots.com
  • URL: https://cloudforbots.com/api/v1/agent-wake/schedule_wake
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Makes the call safe to retry; the same key returns the stored reply for 24h.

X-Request-Idstring

Request body

whenstring required

When to wake: "in 30 minutes", "in 2 hours", "in 3 days", or an ISO time like 2026-10-16T14:00:00Z. Between 1 minute and 365 days out.

repeat_minutesinteger

Optional. Repeat every N minutes after the first wake (free: 60+, Pro: 5+).

stateobject

What your future session needs: goal, progress, next step, IDs. Free up to 8 KB, Pro up to 64 KB.

thread_idstring

Optional conversation or task ID to resume.

callback_urlstring

Optional public https URL to POST the wake to (for example your agent runner webhook). Without it, collect wakes with check_wakes.

inboxstring

Your private inbox name (12+ chars, keep it secret, reuse it every session). Optional if you send an API key: then the key is your inbox.

confirmboolean

false or missing = preview only, nothing saved. true = save the wake.

Response

Tool result (always includes request_id).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.