Sign in
Ai chats

Update ai chat

Update an AI chat's title, notification preferences, or associated account context.

Required permissions:

  • ai_chat:update
patch/ai_chats/{id}

Path parameters

idstring required
Example:aich_xxxxxxxxxxxxx

The unique identifier of the AI chat to update (e.g., "ai_chat_XXXXX").

Request body

current_account_idstring nullable

The unique identifier of the account to set as context for the AI chat (e.g., "biz_XXXXX").

notification_preference'all' | 'none'

The notification preference for an AI chat

titlestring nullable

The new display title for the AI chat thread (e.g., "Help with billing").

Response

A successful response

agent_identifier'general' | 'support' required

The AI agent that handles an AI chat.

blended_token_usagestring required

The total number of tokens consumed across all messages in this conversation.

created_atstring date-time required

The datetime the ai chat was created.

idstring required

The unique identifier for the ai chat.

last_message_atstring date-time nullable required

The timestamp of the most recent message in this conversation. Null if no messages have been sent yet.

message_countinteger required

The total number of messages exchanged in this conversation.

notification_preference'all' | 'none' required

The notification preference for an AI chat

titlestring nullable required

A short descriptive title for this AI chat conversation. Null if no title has been set.

updated_atstring date-time required

The datetime the ai chat was last updated.

Example response

{
  "blended_token_usage": "123.45",
  "created_at": "2023-12-01T05:00:00.401Z",
  "id": "aich_xxxxxxxxxxxxx",
  "last_message_at": "2023-12-01T05:00:00.401Z",
  "message_count": 42,
  "title": "Weekly Revenue Analysis",
  "updated_at": "2023-12-01T05:00:00.401Z",
  "user": {
    "id": "user_xxxxxxxxxxxxx"
  }
}

Changes

Changed in 2 of the 74 revisions of this API.12

  • 35b1eba5f2031See the full diff
    • ○

      added the required property to the response with the status

      response-required-property-added

  • 697924df40d111See the full diff
    • ●

      removed the request property

      request-property-removed

    • ○

      added the new optional request property

      new-optional-request-property

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.