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

# Channel Threads

> Threads that group conversation messages within a channel.

# Channel Threads

A channel thread groups [messages](/response-api-reference/messages) into one conversation within
a channel, so an agent can read the history rather than a single isolated turn.

## Shape

| Field     | Type   | Notes                          |
| --------- | ------ | ------------------------------ |
| `id`      | string | Unique identifier              |
| `uuid`    | string | Stable external identifier     |
| `name`    | string | Thread name                    |
| `user_id` | string | The user the thread belongs to |

## Endpoints

<Warning>
  The paths mix singular and plural: reads use `/v1/channel_threads`, writes use
  `/v1/channel_thread`. Check the individual endpoint page rather than inferring the path from a
  neighbouring one.
</Warning>

| Method   | Path                  |                                                          |
| -------- | --------------------- | -------------------------------------------------------- |
| `GET`    | `/v1/channel_threads` | [List](/response-api-reference/channel-threads/list)     |
| `GET`    | `/v1/channel_threads` | [Get](/response-api-reference/channel-threads/get)       |
| `POST`   | `/v1/channel_thread`  | [Create](/response-api-reference/channel-threads/create) |
| `PUT`    | `/v1/channel_thread`  | [Update](/response-api-reference/channel-threads/update) |
| `DELETE` | `/v1/channel_thread`  | [Delete](/response-api-reference/channel-threads/delete) |

## Example

```bash theme={null}
curl https://api.stateset.com/v1/channel_threads \
  -H "Authorization: Bearer $STATESET_API_KEY"
```

```bash theme={null}
curl -X POST https://api.stateset.com/v1/channel_thread \
  -H "Authorization: Bearer $STATESET_API_KEY" \
  -H 'content-type: application/json' \
  -d '{ "name": "Order #1042 — damaged on arrival" }'
```

## Related

* [Messages](/response-api-reference/messages) — the turns inside a thread
* [Conversations in StateSet Mail](/stateset-mail/conversations) — threading with triage state