Delete a conversation

Delete a local conversation. The conversation and its items can no longer be accessed through these endpoints.

DELETE https://token.moi.matrixorigin.cn/v1/conversations/{conversation_id}

Before you begin

1. Prepare a personal access token with Genesis access.

2. Use the credential used to Create a conversation, and choose a local conversation that has not been deleted or bound to an upstream model.

Request example

Replace $GENESIS_ACCESS_TOKEN and $CONVERSATION_ID with your personal access token and the selected conversation ID.

curl -X DELETE "https://token.moi.matrixorigin.cn/v1/conversations/$CONVERSATION_ID" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN"

Path parameters

Parameter	Type	Required	Description
conversation_id	string	Yes	The id returned when creating the conversation.

Successful response

A successful request confirms deletion; the conversation and its items are no longer accessible.

Response example

{
  "id": "$CONVERSATION_ID",
  "object": "conversation.deleted",
  "deleted": true
}

Fields

Field	Type	Description
id	string	Identifier of the deleted resource.
object	string	Deletion result type.
deleted	boolean	true when deletion succeeds.

Error response

The request returns 404 when the resource is missing, deleted, or inaccessible to the current credential.

Response example

{
  "error": {
    "message": "conversation not found",
    "type": "conversation_not_found",
    "code": "conversation_not_found"
  }
}

Fields

Field	Type	Description
error	object	Error details.
error.message	string	Error description.
error.type	string	Error type.
error.code	string	Error code.

Last updated on Sep 15, 2026