Send input
Queues a user.message (with text and an optional idempotency key) or requests an interruption with user.interrupt. Returns 202 Accepted once the input is recorded locally.
/sessions/{id}/eventsAuthorization
bearer In: header
Path Parameters
Opaque session ID.
^[a-fA-F0-9]{32}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/sessions/string/events" \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "type": "string" }'{ "cursor": "string", "data": null, "id": "string", "input_id": "string", "time": "2019-08-24T14:15:22Z", "type": "string"}Read or stream events GET
Returns a page of retained events as JSON, or streams history and live updates when called with Accept: text/event-stream. Pass after (or Last-Event-ID) with the last retained event's cursor to resume from a known position. Returns 409 cursor_unavailable if the cursor points to an unsynced tail lost during restore.
Flush external state POST
Uploads local event history and the latest completed checkpoint to external storage and returns the resulting checkpoint reference. Requires a management token and configured persistence.