Sign in

Get a single chat.

Changed on

Authorized exactly like the chat's message history, and carrying the fields a surface needs to describe the chat it just opened — which for a delegated run means its provenance and the parameters it was dispatched with, neither of which is reachable through the listing that hides it.

get/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 retrieve

Response

Successfully retrieved the chat

adopted_atstring date-time

Delegated runs only: when the owner first wrote into the run themselves, taking it over from the conversation that dispatched it.

archived_atstring date-time

When this chat was archived by the user, or by the archive cascade of the chat that spawned it.

assistant_idstring

The assistant ID if this chat is based on an assistant.

assistant_namestring

The name of the assistant if this chat is based on an assistant.

can_editboolean required

Whether the current user can edit this chat.

constraintsstring

Delegated runs only: the limits the delegate was told to work within.

created_via'legacy' | 'web' | 'outlook' | 'word' | 'office_addin' | 'ms_teams_tab' | 'ms_teams_bot' required

Surface a chat was created from, stored in chats.created_via.

disabled_mcp_server_idsstring[] required

MCP servers the user switched off for this chat; their tools are not offered to the model.

disabled_mcp_toolsstring[] required

server/tool patterns of MCP tools the user switched off for this chat; matching tools are not offered to the model.

expected_outputstring

Delegated runs only: the result shape the dispatching model asked for.

idstring required
is_pinnedboolean required

Whether this 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. Off, only tools the server marks read-only are offered.

origin_assistant_idstring

The assistant bound to the origin chat at spawn time, if any.

origin_chat_idstring

The origin chat this chat was spawned from, if any. May reference a deleted chat.

origin_chat_titlestring

Resolved display title of the origin chat; absent when the origin no longer exists.

provenance_kindstring

Provenance kind when the chat was spawned from another chat (e.g. delegation for a delegated run). Clients derive "is delegated run" from this value.

title_by_summarystring

Title of the chat as generated by summary automation.

title_by_user_providedstring

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