Skip to main content
DELETE
/
api
/
threads
/
{id}
Delete Draft Thread
curl --request DELETE \
  --url https://app.puffle.ai/api/threads/{id} \
  --header 'Authorization: Bearer <token>'
CLI: 
puffle thread discard --id <id>

​
Overview

Permanently deletes an unsent one-off email draft thread. This endpoint only works when the thread has status: "draft" and has no inbound or outbound messages. It will not delete active conversations, archived conversations, sent one-off emails, campaign conversations, or drafts that already have message history.

​
Path Parameters

ParameterTypeDescription
idstringDraft thread ID.

​
Example

curl -X DELETE "https://app.puffle.ai/api/threads/3d986dd1-9d70-45b7-8e36-5d5b8b1c9337" \
  -H "Authorization: Bearer $PUFFLE_API_KEY"

{
  "deleted": true
}

​
Error Notes

StatusWhen it happens
404The thread does not exist or does not belong to the workspace.
409The thread is not an unsent draft.
500Deletion failed unexpectedly.

​
AI agent notes

Use this only to clean up unsent one-off drafts. To hide a real conversation, archive it with Update thread instead.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Thread (conversations.id) UUID.

Response

Successful response.