Skip to main content
DELETE
/
v1
/
conversations
/
:id
Delete Conversation
curl --request DELETE \
  --url https://api.example.com/v1/conversations/:id

Documentation Index

Fetch the complete documentation index at: https://astralform.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Endpoint

DELETE https://api.astralform.ai/v1/conversations/{conversation_id}

Request

Headers

X-API-Key: af_live_xxxxxxxxxxxx

Path Parameters

ParameterTypeDescription
conversation_idstringThe conversation ID to delete

Response

204 No Content A successful deletion returns no content.

Example

cURL

curl -X DELETE https://api.astralform.ai/v1/conversations/conv_abc123 \
  -H "X-API-Key: af_live_xxxxxxxxxxxx"

Swift

try await client.deleteConversation(id: "conv_abc123")
print("Conversation deleted")

Error Responses

404 Not Found
{
  "error": {
    "code": "conversation_not_found",
    "message": "Conversation conv_abc123 was not found"
  }
}
401 Unauthorized
{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key provided is invalid"
  }
}

Notes

Deletion is permanent and cannot be undone. All messages in the conversation will be lost.
Consider implementing soft-delete in your app if you need to recover deleted conversations.