Read agent events

Authentication

Send your scoped bearer token in the Authorization: Bearer <BEAD_TOKEN> header, or send your API key in X-API-Key.

Parameters

string

required

Machine identifier returned by creation.

integer

default:0

UUID of the resource.

curl --request GET \
  --url "https://api.bead.run/sandboxes/$SANDBOX_ID/events" \
  --header "X-API-Key: $BEAD_API_KEY"

Response

200

Event journal page after the requested cursor.

object[]

required

Events after the requested cursor.

Show Properties

integer

required

Monotonically increasing event sequence number.

string | null

required

Prompt UUID associated with this event. May be null.

object

required

Native or bead runner event; payload varies by method.

Show Properties

string

required

Event method, such as turn/completed or bead/recoveryRequired.

object

Method-specific event payload.

integer

required

Last returned event ID; pass it as after on the next request.

integer

required

Latest event ID in the complete journal.

Errors

Status	Meaning
401	Authentication credential is missing or rejected.
403	The credential lacks the required scope.
404	The requested resource does not exist or is outside your organization.
409	The machine must be resumed, a conversation binding changed, or a request UUID was reused for different prompt content.
410	Execution memory was lost (`machine_lost`).
429	Request or resource admission limit exceeded (`admission_limit`). Follow limit.next_action and Retry-After when present.
502	The runner returned an invalid response.
503	Machine wake or native agent recovery is required, or the runner is unavailable.

Start here

Endpoints

Read agent events

Authentication

Parameters

Response

200

Errors

​Authentication

​Parameters

​Response

​200

​Errors

Authentication

Parameters

Response

200

Errors