Skip to main content
DELETE
/
v2
/
hc-interactions
/
public
curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/hc-interactions/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": [
      "0b8626b0-4cc8-4a3d-8fc2-f18ad1a4a1a8",
      "4d3f4c48-0467-4d7e-bbfd-2f7d02d84b5b"
    ]
  }'

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

​
Headers

​
Authorization
string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.
DELETE /v2/hc-interactions/public
Authorization: Bearer fini_xxxxxxxxxxxxxxxxx
Content-Type: application/json

​
Body parameters

​
ids
array
required
Array of unique conversation IDs to delete. Provide between 1 and 50 UUIDs in one request.
curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/hc-interactions/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": [
      "0b8626b0-4cc8-4a3d-8fc2-f18ad1a4a1a8",
      "4d3f4c48-0467-4d7e-bbfd-2f7d02d84b5b"
    ]
  }'
Current implementation note: bulk delete is not atomic. Matching conversations are removed before the route verifies that every requested ID was accessible. If any ID is missing, already removed, or belongs to a different workspace, the route returns 406 Not Acceptable, but the matching conversations remain removed.

​
Response

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

​
Errors

The body is malformed, ids is missing, there are duplicate IDs, one of the IDs is not a UUID, or you sent more than 50 IDs.
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 these routes.
One or more requested IDs were not accessible to the workspace tied to the API key. The current response message still uses the backend term interactions.
Fini failed while updating the conversation rows in storage.