Channel Threads

A channel thread groups 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

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.

Method	Path
`GET`	`/v1/channel_threads`	List
`GET`	`/v1/channel_threads`	Get
`POST`	`/v1/channel_thread`	Create
`PUT`	`/v1/channel_thread`	Update
`DELETE`	`/v1/channel_thread`	Delete

Example

curl https://api.stateset.com/v1/channel_threads \
  -H "Authorization: Bearer $STATESET_API_KEY"

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" }'

Messages — the turns inside a thread
Conversations in StateSet Mail — threading with triage state

StateSet One API

StateSet API v1

Customer Management

Order Management

Checkouts

Returns Management

Warranty Management

Wholesale Management

Inventory Management

ASN Management

Purchase Orders

Manufacturing

Warehouse Operations

CRM

Suppliers

E-commerce

Financial

Fulfillment

Communication

System

StateSet Response API

StateSet Cloud API

StateSet Commerce API

Channel Threads

Channel Threads

Shape

Endpoints

Example

​Channel Threads

​Shape

​Endpoints

​Example

​Related

Channel Threads

Shape

Endpoints

Example

Related