API Referenceruns

List run events

View as Markdown

List raw machine-readable runtime events for a run.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

runIdstringRequired
Unique run identifier generated by BCTRL.

Headers

BCTRL-Subaccount-IdstringOptional
Optional effective subaccount context for organization API keys. Subaccount API keys are already scoped and cannot use this header to act as another subaccount.

Query parameters

typelist of stringsOptional
Filter by one or more namespaced event types. Repeat the query parameter for multiple values.
sourcelist of enumsOptional
Filter by one or more event sources. Repeat the query parameter for multiple values.
spanIdstringOptional
pageIdstringOptional
cursorstringOptional
limitintegerOptional<=200Defaults to 50

Response

OK
datalist of objects
nextCursorstring or null

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error