curl --request DELETE \
--url https://api.topcalls.ai/v1/leads/{id} \
--header 'Authorization: Bearer <token>'{
"title": "Insufficient Quota",
"status": 402,
"type": "https://api.topcalls.ai/errors/insufficient_quota",
"detail": "You need 5 minutes but have 3.5 remaining",
"instance": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"errors": [
{
"path": "<string>",
"message": "<string>",
"code": "<string>"
}
],
"details": "<string>"
}Without list_id, hard-deletes the lead row (assignments cascade).
With list_id, removes only that assignment; if no assignments remain, the lead row is also deleted.
Requires scope: leads:write.
curl --request DELETE \
--url https://api.topcalls.ai/v1/leads/{id} \
--header 'Authorization: Bearer <token>'{
"title": "Insufficient Quota",
"status": 402,
"type": "https://api.topcalls.ai/errors/insufficient_quota",
"detail": "You need 5 minutes but have 3.5 remaining",
"instance": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"errors": [
{
"path": "<string>",
"message": "<string>",
"code": "<string>"
}
],
"details": "<string>"
}Documentation Index
Fetch the complete documentation index at: https://docs.topcalls.ai/llms.txt
Use this file to discover all available pages before exploring further.