POST /create-chat-completion

Changed on Oct 16, 2026

Create a chat completion message

Request

Base URL
https://api.retellai.com
Auth
HTTP bearer

Request body

chat_idstring required

Unique id of the chat to create completion.

contentstring required

user message to generate agent chat completion.

Example request

{
  "chat_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
  "content": "hi how are you doing?"
}

Response

Successfully created chat completion.

Example response

{
  "messages": [
    {
      "message_id": "Jabr9TXYYJHfvl6Syypi88rdAHYHmcq6",
      "role": "agent",
      "content": "hi how are you doing?",
      "created_timestamp": 1703302428855
    }
  ]
}

Changes

Oct 16, 2026ca41f0dbb297 Revision changes
- breaking
  added to the / response property oneOf list for the response status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
Apr 20, 20268ee53928bf31 Revision changes
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- info
  added subschema #2 to the ///// response property allOf list for the response status
- info
  added subschema #2 to the ///// response property allOf list for the response status
- info
  added subschema #2 to the ///// response property allOf list for the response status
- info
  added subschema #2 to the ///// response property allOf list for the response status
- info
  added subschema #2 to the ///// response property allOf list for the response status

Operation history (3 revisions)