Skip to main content
PATCH
/
api
/
threads
/
{threadId}
curl -X PATCH https://your-worker.workers.dev/api/threads/550e8400-e29b-41d4-a716-446655440000 \
  -H "Content-Type: application/json" \
  -d '{
    "tags": ["support", "escalated", "priority"]
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": "support_agent",
  "user_id": "user_abc123",
  "tags": ["support", "escalated", "priority"],
  "created_at": 1699900000
}
Updates thread properties including tags and agent assignment.
​
threadId
string
required
The unique thread identifier (UUID)
​
tags
array
Array of string tags (replaces existing tags)
​
agent_id
string
New agent to assign to the thread (must be an ai_human type agent)

​
Response

Returns the updated thread object.
​
id
string
required
Thread identifier
​
agent_id
string
required
The agent name associated with this thread
​
user_id
string | null
User identifier if set
​
tags
array
required
Array of string tags
​
created_at
number
required
Unix timestamp in seconds
curl -X PATCH https://your-worker.workers.dev/api/threads/550e8400-e29b-41d4-a716-446655440000 \
  -H "Content-Type: application/json" \
  -d '{
    "tags": ["support", "escalated", "priority"]
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": "support_agent",
  "user_id": "user_abc123",
  "tags": ["support", "escalated", "priority"],
  "created_at": 1699900000
}