Skip to main content
POST
Send events in bulk
Every wallet’s goals run on the agent loop and can use cases.
The same events as Send an event, up to 1,000 in one request. The goal is woken once for the whole request.

Authentication

A signed write proof or an access token: see Authentication schemes.

Request body

Each event has the fields of a single event: event_id, case_key, task, budget_usdc, step_limit. An event_id sent before, in this request or an earlier one, is one event. Events are handled in order.

Response

202 with:
number
Events taken.
object
How many events had each outcome: created, already_open, reopened, sent_to_root, duplicate.
array
{ event_id, reason } for each event not taken, such as a case past the goal’s scoped units or a budget the goal cannot fund. Fix and send those again.

Limits

60 requests per minute for each goal, separate from other routes’ limits. Over it, 429 with Retry-After.

Errors