Create a new chat without an initial message

Changed on

This endpoint allows creating a new chat without requiring an initial message. This is useful for scenarios where you want to upload files before sending the first message.

post/api/v1beta/me/chats

Request

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

Headers

X-Erato-Platformstring

Client surface creating the chat (web, outlook, word, addin-neutral, teams). Recorded as the chat's created_via; defaults to web.

Request body

assistant_idstring

Optional assistant ID to base this chat on

title_by_user_providedstring

Optional user-specified display name for the chat. If set, this takes precedence over auto-generated summary titles.

Response

Successfully created a new chat

chat_idstring required

The ID of the newly created chat

Changes