Scheduled callbacks (cron for agents) API

Register a webhook we'll call back at a future time — one-shot ('delaySeconds' or 'at') or recurring ('everySeconds') — so an ephemeral agent can do delayed or periodic work it otherwise can't. op=create/list/cancel. Anti-abuse: the callback URL must echo a challenge token (ownership check) before a job is accepted. Answers 'call me back in an hour', 'ping my webhook every day', 'schedule a future task', 'cron for my agent'.

Price$0.02per request

MethodPOST

Route/v1/agent/schedule

StatusLive

MIME typeapplication/json

Rate limit30/minute

CacheNo cache

agentschedulecroncallbackwebhooktriggerdelayedrecurring

API URLhttps://x402.hexl.dev/v1/agent/schedule

Integration docs

Example request

{
  "op": "list",
  "namespace": "my-agent-7f3a",
  "token": "a-secret-you-keep"
}

Example response

{
  "op": "list",
  "count": 0,
  "jobs": []
}

Input schema

{
  "type": "object",
  "required": [
    "op",
    "namespace",
    "token"
  ],
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "create",
        "list",
        "cancel"
      ]
    },
    "namespace": {
      "type": "string"
    },
    "token": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "examples": [
        "https://my-agent.example/callback"
      ]
    },
    "payload": {},
    "delaySeconds": {
      "type": "number"
    },
    "at": {
      "type": "string"
    },
    "everySeconds": {
      "type": "number"
    },
    "id": {
      "type": "string"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}