---
title: "Stream progress for a background research task"
method: GET
path: "/v1/research/{task_id}/stream"
---

# Stream progress for a background research task

`GET /v1/research/{task_id}/stream`

Stream real-time progress for a background research task using Server-Sent Events (SSE). The stream starts with a `connected` event, followed by periodic ping comments to keep the connection alive, and closes when the task reaches a terminal status (`completed`, `failed`, or `cancelled`), at which point a terminal event matching the status name is sent. To replay events after reconnecting, pass `?from_id=N` with the last event ID you received. After the stream closes, call `GET /v1/research/{task_id}` to retrieve the full `result` object.

## Path parameters

- `task_id` string, uuid, required

## Query parameters

- `from_id` integer

## Response `200`

A Server-Sent Events stream of task progress updates.

## Other responses

- `401` — Unauthorized. Problems with API key.
- `403` — Forbidden. The API key is not authorized to access this task.
- `404` — Not found. The task ID does not exist.
- `500` — Internal Server Error during authentication/authorization middleware.

---

[API](https://skmtc.net/you/apis/you-com-research-api.md) · [All operations](https://skmtc.net/you/apis/you-com-research-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/you/you-com-research-api/versions/24d9e2eb5297/schema)