agenttools
Messages

Dispatch due messages

No auth required

Delivers every scheduled message whose time has come. In production a Workers cron trigger calls this every minute; external schedulers can call it too, with GET or POST. If `CRON_SECRET` is configured, the caller must present it as `Authorization: Bearer <secret>`.

POST/api/messages/dispatch

Responses

200Summary of the dispatch run.
object"dispatch_result"
dispatchedinteger
deliveredinteger
failedinteger
resultsobject[]
401No valid API key was provided.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.

Example request

curl
curl -X POST https://agtls.dev/api/messages/dispatch