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

​
Overview

Deletes a single company row inside a list. Before the row is removed, every person row in the same list that references this company (company_row_id === cid) is unlinked — their company_row_id is set to null but the people themselves are kept. Company cells cascade automatically via the ON DELETE CASCADE foreign key. This is a hard delete. There is no soft-delete or undo — if you need reversibility, snapshot the row first via getListCompany.

​
AI agent notes

Unlink, don’t cascade people. Linked person rows survive the delete — only the company pointer is nulled out. If you actually want to delete the associated leads too, call the list-rows delete endpoint separately for each one.Cell cleanup is automatic. You do not need to clear list_company_cells before calling this — they are removed transactionally via cascade.Ownership check is strict. The list must be owned by the caller AND the company row must belong to that list. A 404 can mean either; don’t special-case on the exact string.

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)$
​
cid
string<uuid>
required

Company row 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

Company deleted; linked people unlinked; cells cascaded.

​
success
enum<boolean>
required
Available options:
true