Update a thread

Update a thread

PATCH /api/threads/{id}

cURL

curl --request PATCH \
  --url 'https://api.example.com/api/threads/{id}' \
  --header 'x-widget-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "pending"
}'

200

{
  "thread": {},
  "messages": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "sender": "string",
      "text": "Two-person tent, green — replacement for damaged pole set.",
      "timestamp": "2026-08-31T14:22:05Z"
    }
  ]
}

Path parameters

id · string · required

Thread id

Request body

ThreadPatch

status · string

e.g. closed

Response

ThreadWithMessages

thread · object · required

messages · Message[] · required

Show Message

id · string

sender · string

text · string

timestamp · string (date-time)

Status codes

Code	Meaning
200	OK
400	Error
401	Error

cURL

curl --request PATCH \
  --url 'https://api.example.com/api/threads/{id}' \
  --header 'x-widget-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "pending"
}'

200

{
  "thread": {},
  "messages": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "sender": "string",
      "text": "Two-person tent, green — replacement for damaged pole set.",
      "timestamp": "2026-08-31T14:22:05Z"
    }
  ]
}