API ReferenceConversations API

Delete a conversation item

Delete an item from a conversation. The item will be removed from the conversation. **Features:** - Remove specific item from conversation - Automatic ownership verification - Returns updated conversation object after deletion - Items are permanently removed (not soft delete) **Important:** - Deleting an item may affect conversation flow - Item IDs are not reused after deletion - Other items in conversation remain unchanged - Consider creating a new branch instead of deleting items **Response:** Returns the conversation object (not the deleted item)

DELETE
/v1/conversations/{conv_public_id}/items/{item_id}

Authorization

Authorization<token>

Type "Bearer" followed by a space and JWT token.

In: header

Path Parameters

conv_public_idstring

Conversation ID (format: conv_xxxxx)

item_idstring

Item ID to delete (format: msg_xxxxx)

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://loading/v1/conversations/string/items/string"
{
  "branch": "string",
  "branch_created": true,
  "deleted": true,
  "old_main_backup": "string"
}
{
  "code": "string",
  "error": "string",
  "message": "string",
  "request_id": "string"
}
{
  "code": "string",
  "error": "string",
  "message": "string",
  "request_id": "string"
}
{
  "code": "string",
  "error": "string",
  "message": "string",
  "request_id": "string"
}
{
  "code": "string",
  "error": "string",
  "message": "string",
  "request_id": "string"
}

Create a conversation POST

Create a new conversation to store and retrieve conversation state across Response API calls **Features:** - Create conversation with optional metadata (max 16 key-value pairs) - Add up to 20 initial items to the conversation - Returns conversation ID with `conv_` prefix - Supports OpenAI Conversations API format **Metadata Constraints:** - Maximum 16 key-value pairs - Keys: max 64 characters - Values: max 512 characters

Delete a conversation DELETE

Delete a conversation (soft delete). Items in the conversation will not be deleted but will be inaccessible. **Features:** - Soft delete (conversation marked as deleted, not physically removed) - Items remain in database but become inaccessible - Automatic ownership verification - Returns deletion confirmation with conversation ID **Response:** - `id`: Deleted conversation ID - `object`: Always "conversation.deleted" - `deleted`: Always true