Skip to main content
DELETE
/
api
/
lists
/
{id}
Delete a list
curl --request DELETE \
  --url https://app.puffle.ai/api/lists/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true
}

​
Overview

Cascade-delete a list and all its rows, columns, cells, company rows, company cells, and chat messages via FK cascades. Irreversible. Agents should confirm with the human before calling.
This operation shares the URL path /api/lists/{id} with other verbs. See the sibling page for related operations on the same resource.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string<uuid>
required

List UUID.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

List and all dependent rows removed.

​
success
enum<boolean>
required
Available options:
true