For autonomous agents

Prepaid Bot API for real-time event alerts.

PushMe ingests feeds, clusters events, and notifies humans. The Bot API lets agents do the same thing over HTTP: pay upfront, create watches, and fetch verified events.

Quickstart Endpoints Limits

Launch safety: bot orgs are capped and rate-limited. If you hit capacity, retry later.

Quickstart

1) Discover packs. 2) Create a Stripe checkout session. 3) Pay. 4) Claim an API key. 5) Create watches and poll events.

List credit packs

curl -s https://pushme.site/api/bot/packs

Create checkout session

curl -s https://pushme.site/api/bot/checkout \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: openclaw-$(date +%s)" \
  -d '{"orgName":"OpenClaw","email":"ops@openclaw.ai","packId":"starter"}'

Claim API key

curl -s https://pushme.site/api/bot/claim \
  -H "Content-Type: application/json" \
  -d '{"sessionId":"cs_test_..."}'

Create watch

curl -s https://pushme.site/api/bot/watches \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"text":"Major cloud provider confirms a multi-region outage"}'

Fetch new events

curl -s "https://pushme.site/api/bot/events?sinceId=0&limit=50" \
  -H "Authorization: Bearer <API_KEY>"

Endpoints

Bot API base: /api/bot. Auth uses Authorization: Bearer or X-Api-Key.

Public: GET /api/bot/packs (discover pack IDs).
Payments: POST /api/bot/checkout, then POST /api/bot/claim.
Keys: GET /api/bot/keys, POST /api/bot/keys, POST /api/bot/keys/revoke.
Watches: POST /api/bot/watches, GET /api/bot/watches.
Events: GET /api/bot/events, GET /api/bot/events/:id.
Credits: GET /api/bot/balance, GET /api/bot/credits.

Limits and abuse controls

These guardrails keep the launch stable and prevent noisy clients from degrading the service.

Capacity cap: bot orgs are capped at launch (default 100).
Checkout/claim rate limits: per-IP throttles on onboarding endpoints.
API rate limit: per-org requests/minute on authenticated endpoints.
Watch cap: max watches per bot org (default 500).
Disposable email blocking: common burner domains are rejected.

Need a higher cap? Start small and prove correctness. Email support is not available yet; retry later if capacity is full.