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'
import requests
conversation_id = "0b8626b0-4cc8-4a3d-8fc2-f18ad1a4a1a8"
response = requests.delete(
f"https://api-prod.usefini.com/v2/hc-interactions/{conversation_id}/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
result = response.json()
const conversationId = "0b8626b0-4cc8-4a3d-8fc2-f18ad1a4a1a8";
const response = await fetch(
`https://api-prod.usefini.com/v2/hc-interactions/${conversationId}/public`,
{
method: "DELETE",
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const result = await response.json();
{
"success": true
}
{
"statusCode": 401,
"message": "Invalid or revoked API key",
"error": "Unauthorized"
}
{
"statusCode": 403,
"message": "API key does not have the required scope for this operation",
"error": "Forbidden"
}
Conversations
Delete conversation
Delete one conversation by ID through the public Conversations API.
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'
import requests
conversation_id = "0b8626b0-4cc8-4a3d-8fc2-f18ad1a4a1a8"
response = requests.delete(
f"https://api-prod.usefini.com/v2/hc-interactions/{conversation_id}/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
result = response.json()
const conversationId = "0b8626b0-4cc8-4a3d-8fc2-f18ad1a4a1a8";
const response = await fetch(
`https://api-prod.usefini.com/v2/hc-interactions/${conversationId}/public`,
{
method: "DELETE",
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const result = await response.json();
{
"success": true
}
{
"statusCode": 401,
"message": "Invalid or revoked API key",
"error": "Unauthorized"
}
{
"statusCode": 403,
"message": "API key does not have the required scope for this operation",
"error": "Forbidden"
}
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
string
required
Bearer token containing your Fini workspace API key. Format:
Bearer fini_... The key needs write scope.Path parameters
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'
import requests
conversation_id = "0b8626b0-4cc8-4a3d-8fc2-f18ad1a4a1a8"
response = requests.delete(
f"https://api-prod.usefini.com/v2/hc-interactions/{conversation_id}/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
result = response.json()
const conversationId = "0b8626b0-4cc8-4a3d-8fc2-f18ad1a4a1a8";
const response = await fetch(
`https://api-prod.usefini.com/v2/hc-interactions/${conversationId}/public`,
{
method: "DELETE",
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const result = await response.json();
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
boolean
true when the route completed successfully.{
"success": true
}
{
"statusCode": 401,
"message": "Invalid or revoked API key",
"error": "Unauthorized"
}
{
"statusCode": 403,
"message": "API key does not have the required scope for this operation",
"error": "Forbidden"
}
Errors
401 Unauthorized
401 Unauthorized
The API key is missing, malformed, revoked, or invalid. Confirm you are sending
Authorization: Bearer fini_... with the full key.403 Forbidden
403 Forbidden
The API key does not include the
write scope required for this route.500 Internal Server Error
500 Internal Server Error
Fini failed while updating the conversation row in storage.
Was this page helpful?

