Skip to main content
DELETE
/
v1
/
contacts
/
lists
/
{id}
curl -X DELETE "https://api.teli.ai/v1/contacts/lists/{list_id}?user_id={user_id}&is_admin=false" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "Contact list deleted successfully",
  "powered_by": "Teli"
}

​
Description

Delete a contact list and its associated contacts. Access control is enforced:
  • Admin users: Can delete any list in the organization
  • Regular users: Can only delete lists they created

​
Authorizations

​
X-API-Key
string
required
Authentication header

​
Path Parameters

​
id
string
required
Contact list unique_id

​
Query Parameters

​
user_id
string
User unique_id (for access control verification)
​
is_admin
boolean
If true, admin can delete any list. If false/missing, user can only delete their own lists.
curl -X DELETE "https://api.teli.ai/v1/contacts/lists/{list_id}?user_id={user_id}&is_admin=false" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "Contact list deleted successfully",
  "powered_by": "Teli"
}