Skip to main content
PATCH
Update Chat

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

chat_id
string
required

Chat ID

Body

The chat update schema

title
string | null

The title of the chat

model
string

The model used for the chat

visibility
enum<string>

The visibility of the chat

Available options:
PRIVATE,
PUBLIC_READ,
PUBLIC_WRITE
pinned
boolean

Whether the chat is pinned in the user interface

tools
object[]

The tools available in the chat

Maximum array length: 100
features
object

Per-chat features and run settings: model features plus approval mode, auto-discover, and org-chat tool toggles.

Response

200 - application/json
id
string
required
title
string | null
required

The title of the chat

model
string
required

The model used for the chat

members
object[]
required

The members of the chat

temporary
boolean
required

Whether the chat is temporary and would be deleted after 24 hours of last activity

visibility
enum<string>
required

The visibility of the chat

Available options:
PRIVATE,
PUBLIC_READ,
PUBLIC_WRITE
pinned
boolean
required

Whether the chat is pinned in the user interface

status
enum<string>
required

The status of the chat

Available options:
RUNNING,
COMPLETED,
FAILED,
CANCELED
shared_url
string | null
required

The shared URL of the chat, if it is shared

created_at
string<date-time> | null
required
updated_at
string<date-time> | null
required
tools
object[]

The tools available in the chat

skills
object[]

The skills enabled in the chat

features
object

Per-chat features and run settings: model features plus approval mode, auto-discover, and org-chat tool toggles.

org_id
string
agent
object

The agent whose run this chat is

routine
object

The routine whose fire started this chat

state
object

Schema for the chat state

The link to the chat in the integration

last_message
object

The chat message schema

referral
object

Referral/commerce event data from Meta platforms — ads, products, orders.

reminders
object[]

The active reminders scheduled on this chat