Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Stream signed events

/api/v1/owner/runs/{id}/eventsGET
Server-sent events, polled from durable evidence every 800 ms. Each frame has id equal to the event sequence and a JSON data field. Reconnect with Last-Event-ID. Example frame:
id: 1 data: {"sequence":1,"type":"run.stopped","data":{"version":1}}
The abbreviated frame above illustrates framing; the complete event shape is EvidenceEvent.
Examples are synthetic and illustrate response shape; IDs, signatures, and credentials are not usable authority.
Authorization
ownerSession *cookie halfspan_session
Authenticated HttpOnly owner session. Not an executor credential.
Response
200 · Server-sent events, polled from durable evidence every 800 ms. Each frame has id equal to the event sequence and a JSON data field. Reconnect with Last-Event-ID. Example frame: ```text id: 1 data: {"sequence":1,"type":"run.stopped","data":{"version":1}} ``` The abbreviated frame above illustrates framing; the complete event shape is EvidenceEvent.
Server-sent events, polled from durable evidence every 800 ms. Each frame has id equal to the event sequence and a JSON data field. Reconnect with Last-Event-ID. Example frame:
id: 1 data: {"sequence":1,"type":"run.stopped","data":{"version":1}}
The abbreviated frame above illustrates framing; the complete event shape is EvidenceEvent.
400 · Request validation failed.
error *string
reasonCode?string
401 · Sign in to the Halfspan workspace.
error *string
reasonCode?string
403 · Console requests must come from the local owner workspace.
error *string
reasonCode?string
404 · Run not found
error *string
reasonCode?string
500 · The local service could not complete this request.
error *string
reasonCode?string
Request example
curl -X GET "https://service.example.com/api/v1/owner/runs/11111111-1111-4111-8111-111111111111/events" \ -H "Last-Event-ID: 0" \ -b "halfspan_session=<token>"
Response example
{ "error": "Request validation failed.", "reasonCode": "REQUEST_ERROR" }