Sign in
Chat

Get chat messages

Get the messages in a stored chat completion. Only Chat Completions that have been created with the store parameter set to true will be returned.

get/chat/completions/{completion_id}/messages

Path parameters

completion_idstring required

The ID of the chat completion to retrieve messages from.

Query parameters

afterstring

Identifier for the last message from the previous pagination request.

limitinteger

Number of messages to retrieve.

order'asc' | 'desc'

Sort order for messages by timestamp. Use asc for ascending order or desc for descending order. Defaults to asc.

Response

A list of messages

object'list' required

The type of this object. It is always set to "list".

first_idstring required

The identifier of the first chat message in the data array.

last_idstring required

The identifier of the last chat message in the data array.

has_moreboolean required

Indicates whether there are more chat messages available.

Changes

Changed in 1 of the 31 revisions of this API.2

  • e0508a503b842See the full diff
    • ○

      added the optional property data/items/allOf[subschema #2]/content_parts/anyOf[subschema #1]/items/anyOf[subschema #1: Text content part]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/items/allOf[subschema #2]/content_parts/anyOf[subschema #1]/items/anyOf[subschema #2: Image content part]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog