Conversations

Create items

Changed on Oct 26, 2026

Create items in a conversation with the given ID.

post/conversations/{conversation_id}/items

Request

Base URL
https://api.openai.com/v1
URL
https://api.openai.com/v1/conversations/{conversation_id}/items
Auth
HTTP bearer

Path parameters

conversation_idstring required

Example:conv_123

The ID of the conversation to add the item to.

Query parameters

includeIncludeEnum[]

Additional fields to include in the response. See the include parameter for listing Conversation items above for more information.

Request body

Response

object'list' required

The type of object returned, must be list.

has_moreboolean required

Whether there are more items available.

first_idstring required

The ID of the first item in the list.

last_idstring required

The ID of the last item in the list.

Changes

Oct 26, 20266f5c52c2ff04 Revision changes
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property /////////
- info
  added the new optional request property /////////
- info
  added the new optional request property /////////
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
Oct 23, 2026f1af3e12b410 Revision changes
- info
  the request property default value changed from gpt-image-1 to gpt-image-2
- info
  the request property default value changed from gpt-image-1 to gpt-image-2
- info
  the response's property default value changed from gpt-image-1 to gpt-image-2 for the status
- info
  the response's property default value changed from gpt-image-1 to gpt-image-2 for the status

Operation history (42 revisions)