Sign in

Update mutable fields on a chat.

Changed on

Supports updating the user-provided title, pin state, the MCP write tools toggle and the disabled MCP server and tool lists.

put/api/v1beta/me/chats/{chat_id}

Request

  • The document declares no server URL.
  • Auth: bearer_auth (a scheme the document does not define)

Path parameters

chat_idstring required

The ID of the chat to update

Request body

disabled_mcp_server_idsstring[]

MCP servers to switch off for this chat; replaces the stored list. Their tools are withheld from the model. Only ever narrows the set the policy, assistant and facets allow.

disabled_mcp_toolsstring[]

server/tool patterns of MCP tools to switch off for this chat; replaces the stored list. Matching tools are withheld from the model. Only ever narrows the set the policy, assistant, facets and the server list allow; a pattern naming a tool the server no longer exposes does nothing.

is_pinnedboolean nullable

Whether the chat should be pinned.

mcp_write_tools_enabledboolean nullable

Whether the model may be offered MCP write tools and client actions in this chat. Off, only tools the server marks read-only are offered and client-action proposals are withheld.

title_by_user_providedstring

Optional user-provided title update.

  • \"some title\" sets the title
  • null removes a previously set title
  • omitted is treated the same as null

Response

Successfully updated the chat

chat_idstring required

The ID of the updated chat

disabled_mcp_server_idsstring[] required

MCP servers the user switched off for this chat.

disabled_mcp_toolsstring[] required

server/tool patterns of MCP tools the user switched off for this chat.

is_pinnedboolean required

Whether the chat is pinned by its owner.

mcp_write_tools_enabledboolean required

Whether the model may be offered MCP write tools and client actions in this chat.

title_by_summarystring nullable

Title of the chat as generated by summary automation.

title_by_user_providedstring nullable

Title of the chat as explicitly provided by the user.

title_resolvedstring required

Resolved chat title where user-provided title takes precedence over summary title.

Changes

  • c39554ac8a0dRevision changes
    • info

      added the new optional request property

    • info

      added the required property to the response with the status

  • 63c0c1766430Revision changes
    • info

      added the new optional request property

    • info

      added the required property to the response with the status