API: sse

Status: GA Access: token required API contract: 0.3.0 · capability 2026-09-03.1 View as Markdown Open in Claude Open in ChatGPT

`GET /api/v1/sse/all`

Sse All

Open as a page →

Subscribe to every event channel.

Auth: Authorization: Bearer <token> required

Parameter	In	Required	Type	Description
`access_token`	query	no	`string \| null`

Responses:

Code	Meaning	Body
`200`	Successful Response	`object`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`

`GET /api/v1/sse/integrations`

Sse Integrations

Open as a page →

connection status-change events.

The integrations health-checker emits integration.status whenever a connection’s credential or health status changes.

Auth: Authorization: Bearer <token> required

Parameter	In	Required	Type	Description
`access_token`	query	no	`string \| null`

Responses:

Code	Meaning	Body
`200`	Successful Response	`object`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`

`GET /api/v1/sse/lifecycle`

Sse Lifecycle

Open as a page →

lifecycle SSE channel.

Emits: lifecycle.transitioned, lifecycle.autorun.completed, lifecycle.message, lifecycle.batch.completed. Source of truth — LifecycleEngine, which publishes only after session.commit. Multi-worker note: in-memory bus is MVP; Redis-backed migration is (same pattern as runs:sse.

Auth: Authorization: Bearer <token> required

Parameter	In	Required	Type	Description
`access_token`	query	no	`string \| null`

Responses:

Code	Meaning	Body
`200`	Successful Response	`object`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`

`GET /api/v1/sse/publish`

Sse Publish

Open as a page →

Subscribe to publish/deploy progress events.

Auth: Authorization: Bearer <token> required

Parameter	In	Required	Type	Description
`access_token`	query	no	`string \| null`

Responses:

Code	Meaning	Body
`200`	Successful Response	`object`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`

`GET /api/v1/sse/runs`

Sse Runs

Open as a page →

Subscribe to pipeline-run events — Redis-backed, multi-worker.

Auth: Authorization: Bearer <token> required

Parameter	In	Required	Type	Description
`access_token`	query	no	`string \| null`

Responses:

Code	Meaning	Body
`200`	Successful Response	`object`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`

`GET /api/v1/sse/workspace`

Sse Workspace

Open as a page →

Workspace channel.

Emits: spec., issue., defect., comment., agent_action.* events.

Auth: Authorization: Bearer <token> required

Parameter	In	Required	Type	Description
`access_token`	query	no	`string \| null`

Responses:

Code	Meaning	Body
`200`	Successful Response	`object`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`