schedule

SCHEDULE: arm a time-driven callback, scoped to YOUR wallet...

SCHEDULE: arm a time-driven callback, scoped to YOUR wallet — the time-based twin of watchers. We POST your payload to callbackUrl either once at a future time (at) or repeatedly (everySeconds, ≥60). Each push is EIP-191-signed by our published key (verify offline) and retried with backoff. Pay once; bounded by maxFires + a 90-day window. Gives a stateless agent a cron without a server. No account or API key — pay per call with x402.

post/api/schedule/create

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/schedule/create
  • Auth: API key in header PAYMENT-SIGNATURE

Request body

callbackUrlstring uri required

Where we POST when it fires. Any http(s) URL; the JSON body is signed (verify with X-2s-Signature).

atstring

ISO-8601 timestamp for a ONE-SHOT fire. e.g. "2026-07-01T14:00:00Z". Provide this OR everySeconds, not both.

everySecondsinteger

Recurring interval in seconds (≥60). Provide this OR at.

payloadobject

Arbitrary JSON echoed in every callback (plus scheduleId, fireNumber, firedAt). e.g. {"job":"digest"}.

maxFiresinteger

Stop after this many fires (recurring only). Default 25, max 1000.

expiresInSecondsinteger

Auto-expire the schedule after this long. Default + max 90 days.

labelstring

Optional free-text tag to recognize this schedule later.

Response

(unresolved $ref)

Changes

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