---
title: "Post Thread Visibility"
method: POST
path: "/v1/threads/{thread_id}/visibility"
---

# Post Thread Visibility

`POST /v1/threads/{thread_id}/visibility`

## Request

- Base URL: `https://www.tandem-cc.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.tandem-cc.com/v1/threads/{thread_id}/visibility`
- Auth: none declared

Set a thread's visibility (active | archived | junk) for the
calling handle. This is a PER-HANDLE overlay — it never touches the
shared corpus; the thread stays recoverable and immutable.

Auth scopes:
  - admin (X-Tandem-Api-Key): may set visibility for any handle via
    a "handle" field in the body (operator tooling).
  - bearer / session: sets it ONLY for the handle it is bound to.
    Visibility is a personal view, so a handle is required.

## Path parameters

- `thread_id` string, required

## Headers

- `X-Tandem-Api-Key` string, nullable
- `Authorization` string, nullable

## Request body

- object

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tandem-cc/apis/tandem-api.md) · [All operations](https://skmtc.dev/tandem-cc/apis/tandem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tandem-cc/apis/tandem-api/revisions/3b804877b47c?raw)