Skip to navigation
Command reference

events Commands

View as Markdown

Manage events

Output formatting flags (--json, --jq, and --template) are documented once in Output Formatting and are omitted from the tables below.

bctrl events get

Read one Event by its ID.

bctrl events get <eventId> [flags]
FlagDescription
--headers <json>API headers: inline JSON, @file, or - for stdin
--api-version <date>Dated API contract (default: 2026-10-03)
--space <id-or-name>Select an authorized Space (BCTRL-Space)
--subaccount-id <id>Effective subaccount context (BCTRL-Subaccount-Id)

bctrl events list

List immutable Events visible in the organization, subaccount and selected Space: every kind of Event, read in one place. Filter by browser, sandbox, Run, Task, Conversation (its history), agent, category (audit logs are the always-on categories), type, actor, channel, outcome or time.

bctrl events list [flags]
FlagDescription
--query <json>Query object: inline JSON, @file, or - for stdin
--params <json>Alias for —query
--browser <value>Query parameter browser
--sandbox <value>Query parameter sandbox
--run <value>Query parameter run
--task <value>Query parameter task
--conversation <value>Query parameter conversation
--agent <value>Query parameter agent
--category <value>Query parameter category
--type <value>Query parameter type
--actor <value>Query parameter actor
--actor-type <value>Query parameter actorType
--channel <value>Query parameter channel
--outcome <value>Query parameter outcome
--from <value>Query parameter from
--to <value>Query parameter to
--cursor <value>Query parameter cursor
--order <value>Query parameter order
--limit <value>Query parameter limit
--headers <json>API headers: inline JSON, @file, or - for stdin
--api-version <date>Dated API contract (default: 2026-10-03)
--space <id-or-name>Select an authorized Space (BCTRL-Space)
--subaccount-id <id>Effective subaccount context (BCTRL-Subaccount-Id)

bctrl events stream

Stream the same Events as they are committed, with the same filters. Resume after an Event ID with Last-Event-ID or after: the stream is in commit order, so a resumed stream has no gaps.

bctrl events stream [flags]
FlagDescription
--query <json>Query object: inline JSON, @file, or - for stdin
--params <json>Alias for —query
--browser <value>Query parameter browser
--sandbox <value>Query parameter sandbox
--run <value>Query parameter run
--task <value>Query parameter task
--conversation <value>Query parameter conversation
--agent <value>Query parameter agent
--category <value>Query parameter category
--type <value>Query parameter type
--actor <value>Query parameter actor
--actor-type <value>Query parameter actorType
--channel <value>Query parameter channel
--outcome <value>Query parameter outcome
--from <value>Query parameter from
--to <value>Query parameter to
--after <value>Query parameter after
--headers <json>API headers: inline JSON, @file, or - for stdin
--api-version <date>Dated API contract (default: 2026-10-03)
--space <id-or-name>Select an authorized Space (BCTRL-Space)
--subaccount-id <id>Effective subaccount context (BCTRL-Subaccount-Id)
--last-event-id <id>Resume the event stream after this event
--timeout-ms <milliseconds>End the stream after this duration (1–60000)
--max-events <number>End after this many SSE events (1–200)