Channel Threads

Threads that group conversation messages within a channel.

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

Related

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