---
title: "Real-time SSE stream of task lifecycle events for the authenticated org"
method: GET
path: "/api/v1/tasks/stream"
tags: ["tasks"]
---

# Real-time SSE stream of task lifecycle events for the authenticated org

`GET /api/v1/tasks/stream`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/api/v1/tasks/stream`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

Long-lived Server-Sent Events stream per ADR-011 Option D.

**Events**
- `snapshot` — emitted once at connect; all PENDING tasks + last `completed_limit` COMPLETED tasks, ordered by `created_at DESC`.
- `task-created` — new task row inserted.
- `task-updated` — status, name, `input_payload`, `result_payload`, or `reopen_count` changed.
- `task-resolved` — status flipped to `COMPLETED`.
- `: keepalive` — comment line every 30 s of idle to keep proxies alive.

**Termination**: close the connection from the client side. The server never sends a terminal event.

## Query parameters

- `completed_limit` integer: Cap on COMPLETED tasks in the initial snapshot. PENDING tasks are always included in full.

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)