---
title: "Set (or, with label null, clear) a triage label on an inbox thread."
method: POST
path: "/threads/{id}/label"
tags: ["inbox"]
---

# Set (or, with label null, clear) a triage label on an inbox thread.

`POST /threads/{id}/label`

## Request

- Base URL: `https://api.coldrig.dev`
- URL: `https://api.coldrig.dev/threads/{id}/label`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- ThreadLabelInput
  - `label` string, nullable: Free-form (a UI-recommended taxonomy, not a server-enforced enum). null clears the label.

## Response `200`

Label set/cleared.

- object
  - `threadId` string, required
  - `label` string, nullable, required
  - `source` 'dashboard' | 'mcp' | 'api' | 'system', nullable, required

## Other responses

- `400`: Request body failed schema validation.
- `401`: Missing, invalid, or inactive bearer token.
- `404`: Resource not found, or not owned by the authenticated account.

---

[API](https://skmtc.dev/coldrig/apis/agent-cold-email-api.md) · [All operations](https://skmtc.dev/coldrig/apis/agent-cold-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coldrig/apis/agent-cold-email-api/revisions/242a462d82c4?raw)