Skip to content
/
Update thread
Last updated

Update thread

Modify thread properties including metadata, title, and visibility settings. Industry-standard compatible with Freddy enhancements.

PATCHhttps://api.aitronos.com/v1/threads/{thread_id}

Modify thread properties including metadata, title, assistant binding, and visibility settings. Uses partial updates - only provided fields are modified. Only the thread creator can update it.

Path Parameters

thread_id string required

The unique identifier of the thread to update.

Request Body

metadata object optional

Custom key-value pairs for thread metadata. Performs partial update - merges with existing metadata. Maximum 16 key-value pairs.

title string optional

Display name for the thread. Maximum 200 characters. Full replacement of existing title.

assistant_id string optional

ID of the assistant to bind to this thread. Note: Cannot be changed once the thread has messages. The assistant binding is locked after the first message to ensure conversation consistency.

visible_in_ui boolean optional

Whether this thread should be visible in the user interface. Requires Bearer token authentication.

Bash
curl -X POST "https://api.aitronos.com/v1/threads/thread_abc123" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Thread Title"
  }'

Response:

{
  "id": "thread_abc123",
  "created_at": "2025-11-17T10:00:00Z",
  "metadata": {
    "userId": "user_abc",
    "source": "docs",
    "priority": "low",
    "status": "resolved"
  },
  "organization_id": "org_12345",
  "title": "Updated Thread Title",
  "lastMessageAt": "2025-11-17T10:05:00Z",
  "assistant_id": "asst_abc123",
  "status": "active",
  "visibleInUi": true
}
Previous page
Next page