> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workstreams

> Read and maintain Blueprint workstreams over the Platform API.

A workstream is a strategic swim lane on the quarterly Blueprint, owned by the company, a department or a team. Reads use the `objectives:read` scope and require that permission at the deployment root. Writes use the `projects:manage` scope together with `objectives:read` and require both permissions at the deployment root. A tenant-only grant receives `403 permission_denied`.

## Operations

* [List workstreams](https://docs.gloo.com/forge/reference/http-api/workstreams/list.md) — by owner, by status, or newest first; cursor paging up to 100 rows
* [Get workstream](https://docs.gloo.com/forge/reference/http-api/workstreams/get.md) — one workstream by id

## Write operations

* [Create workstream](https://docs.gloo.com/forge/reference/http-api/workstreams/create.md) — always `ACTIVE`
* [Update workstream](https://docs.gloo.com/forge/reference/http-api/workstreams/update.md) — name, description, owner or status; `ARCHIVED` archives

Workstreams are never deleted over the API. Every write accepts an optional `Idempotency-Key`. A same-key retry within 24 hours returns the recorded result only while the caller still holds `objectives:read` and `projects:manage` at the deployment root; otherwise `409 idempotency_result_unavailable`, and the write never runs twice. A successful write records no audit event, as the Console's planning writes record none; a refused write records a denial.

List cursors are bound to the filters that created them. Reusing one with different filters returns `400 bad_request`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.