API ReferenceConversations API

Delete a conversation

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

DELETE
/v1/conversations/{conv_public_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)

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://loading/v1/conversations/string"
{
  "deleted": true,
  "id": "string",
  "object": "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"
}

Delete a conversation item DELETE

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)

Get project GET

Get a single project by ID