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

​
Overview

Deletes a deep_research_people row owned by the authenticated user. FK cascade removes:
  • All raw enrichment data (LinkedIn scrapes, Tavily hits, FullEnrich responses)
  • Every report version in deep_research_reports
This is irreversible — there is no undo and no soft-delete. Does NOT cancel an in-flight Trigger.dev enrichment task. If a pipeline is still running when the row is deleted, the task will finish executing; its terminal writes will fail silently against the missing FK. The caller sees nothing. Internal UI endpoint. Partner-authenticated callers should use deleteResearchV1.

​
AI agent notes

Destructive and irreversible. Always confirm with the human before calling. There is no trash, no audit log, and no 7-day restore window.Pre-check. If the row’s status is running, the enrichment pipeline is in flight. Consider waiting for completion before deleting — otherwise the report generated by the task will be lost.Idempotency. After a successful delete, listDeepResearchPeople no longer returns the row. A second delete on the same id returns 404.No side effects on the caller’s credit balance. Credits spent on completed runs are not refunded.

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

Deep research person 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

Person and all cascaded data removed.

​
success
enum<boolean>
required
Available options:
true