Skip to main content
DELETE
/
v2
/
hc-interactions
/
{id}
/
public
curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/hc-interactions/0b8626b0-4cc8-4a3d-8fc2-f18ad1a4a1a8/public' \
  --header 'Authorization: Bearer fini_your_api_key'

{
  "success": true
}
Use this endpoint to delete one conversation from the workspace tied to your API key.
Use List conversations to discover IDs before deleting. If you need to remove multiple conversations in one request, use Bulk delete conversations.

​
Headers

​
Authorization
string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.

​
Path parameters

​
id
string
required
Conversation ID to delete.
curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/hc-interactions/0b8626b0-4cc8-4a3d-8fc2-f18ad1a4a1a8/public' \
  --header 'Authorization: Bearer fini_your_api_key'
Current implementation note: this route returns { "success": true } once the update query completes. It does not currently verify that the ID matched a live conversation, so missing, already-removed, or workspace-mismatched IDs can still return success.

​
Response

​
success
boolean
true when the route completed successfully.
{
  "success": true
}

​
Errors

The API key is missing, malformed, revoked, or invalid. Confirm you are sending Authorization: Bearer fini_... with the full key.
The API key does not include the write scope required for this route.
Fini failed while updating the conversation row in storage.