curl -X DELETE \
'https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a' \
-H 'Authorization: Bearer YOUR_TOKEN'
const response = await fetch('https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
});
const data = await response.json();
<?php
$client = new \GuzzleHttp\Client();
$response = $client->delete('https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a', [
'headers' => [
'Authorization' => 'Bearer YOUR_TOKEN',
],
]);
$data = json_decode($response->getBody());
{
"success": true,
"message": "Webhook deleted successfully"
}
Agent Webhooks
Delete Webhook
Permanently delete a webhook configuration
DELETE
/
api
/
v1
/
agents
/
{agent_id}
/
webhooks
/
{webhook_id}
curl -X DELETE \
'https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a' \
-H 'Authorization: Bearer YOUR_TOKEN'
const response = await fetch('https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
});
const data = await response.json();
<?php
$client = new \GuzzleHttp\Client();
$response = $client->delete('https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a', [
'headers' => [
'Authorization' => 'Bearer YOUR_TOKEN',
],
]);
$data = json_decode($response->getBody());
{
"success": true,
"message": "Webhook deleted successfully"
}
Overview
Permanently deletes a webhook configuration. This action cannot be undone.Endpoint
string
required
Agent UUID
string
required
Webhook UUID
Request
curl -X DELETE \
'https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a' \
-H 'Authorization: Bearer YOUR_TOKEN'
const response = await fetch('https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
});
const data = await response.json();
<?php
$client = new \GuzzleHttp\Client();
$response = $client->delete('https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a', [
'headers' => [
'Authorization' => 'Bearer YOUR_TOKEN',
],
]);
$data = json_decode($response->getBody());
Response
boolean
Indicates if the webhook was deleted successfully
string
Success message
{
"success": true,
"message": "Webhook deleted successfully"
}
Error responses
{
"message": "Missing Bearer Token"
}
{
"success": false,
"message": "Agent not found in this environment."
}
{
"success": false,
"message": "Webhook not found."
}
Important notes
- This action permanently deletes the webhook configuration and cannot be undone
- Webhook operations automatically clear the agent cache for immediate effect
- Consider disabling the webhook first if you want to temporarily stop notifications
- Deleted webhooks will no longer receive any events
Related endpoints
- List Agent Webhooks - Get all webhooks for an agent
- Create Webhook - Set up a new webhook
- Get Webhook Details - Retrieve specific webhook information
- Update Webhook - Modify webhook configuration
- Toggle Webhook Status - Enable/disable webhook
- Test Webhook - Send test payload to verify connectivity
Was this page helpful?