Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Items

Manage conversations and conversation items.

Create items
client.conversations.items.create(conversationID, params, options?): ConversationItemList { data, first_id, has_more, 2 more }
POST
/conversations/{conversation_id}/items
Delete an item
client.conversations.items.delete(itemID, params, options?): Conversation { id, created_at, metadata, object }
DELETE
/conversations/{conversation_id}/items/{item_id}
List items
client.conversations.items.list(conversationID, query?, options?): ConversationCursorPage<ConversationItem>
GET
/conversations/{conversation_id}/items
Retrieve an item
client.conversations.items.retrieve(itemID, params, options?): ConversationItem
GET
/conversations/{conversation_id}/items/{item_id}
Models
ConversationItem = Message { id, content, role, 3 more } | ResponseFunctionToolCallItem { id, status, created_by } | ResponseFunctionToolCallOutputItem { id, output, status, 6 more } | 26 more

A single item within a conversation. The set of possible types are the same as the output type of a Response object.

ConversationItemList { data, first_id, has_more, 2 more }

A list of Conversation items.