Skip to main content
DELETE
/
api
/
lists
Delete List
curl --request DELETE \
  --url https://app.puffle.ai/api/lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>"
}
'
{
  "success": true
}
CLI: 
puffle list delete --id <id>

​
Overview

Deletes a user-created List. The canonical Lead records remain in the workspace and may still belong to other Lists, including the protected all List. Pass id in the JSON body. The default all List cannot be deleted.
This is destructive for List organization but not for Leads themselves. Agents should confirm the target List name and id with the human before calling.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
id
string
required

List UUID to delete.

Minimum string length: 1

Response

List deleted.

​
success
enum<boolean>
required
Available options:
true