API reference
Keep a page current with one stream of a workspace's task starts and ends.
A single Server-Sent Events stream sends a frame each time a task starts or ends in the workspace.
Request
A frame names the task, its harness, its workspace, who started it, what happened and when, never its content. Read the task itself for that.
GET /v1/events Accept: text/event-stream
Limits
- Open streams
- Limited per organization. One over the limit answers 429 with
too_many_streams. - Reconnecting
- After a dropped stream reconnects, read the task list once to catch anything that changed while it was down.
- Streaming eventsThe stream of one task, frame by frame.
Ready to run this against a live workspace?Create API key