agenttools
Inboxes

Purge expired events

No auth required

Deletes every expired inbox event across all inboxes. 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/inboxes/purge

Responses

200Summary of the purge run.
object"purge_result"
purgedinteger
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/inboxes/purge