sales

Delete Lead

Take a lead off the board.

Frederick, 2026-08-21: "I have no way to delete a lead. I should be able to delete a lead. I'm an admin... I should be able to do it." There was no endpoint at all, so a board that could only be added to filled with test rows and mistakes, each one permanently in the denominator of every pipeline number.

sales:write, the same grant that creates and moves a lead, rather than a new one. Somebody trusted to drag a lead into Disqualified and record a loss is trusted to remove one they should not have made; inventing a separate permission for the smaller act would be ceremony, and Frederick's own framing was that an admin should simply be able to.

204, no body: there is nothing left to return, and a caller that got a lead back would have to decide what to do with it.

delete/api/sales/leads/{lead_id}

Request

  • Base URL: https://api.pigeonly.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pigeonly.com/api/sales/leads/{lead_id}
  • Auth: none declared

Path parameters

lead_idstring uuid required

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.