CRM

Delete a deal

Tombstones a trattativa and closes out every activity hanging off it, so its open tasks stop nagging in «Le mie attività» and on the dashboard. The stage history is kept — every funnel number is computed from it — but the deal leaves every list, every board and every forecast. There is no undo from here: read it with crm_get_deal and get an explicit yes from the user before calling this.

Examples

  • That deal was entered twice — remove the duplicate DELETE /api/v1/rest/crm/deals/22222222-3333-4444-8555-666666666666
delete/api/v1/rest/crm/deals/{id}

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/crm/deals/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The deal id, from crm_list_deals or crm_get_deal.

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

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