Delete a quote
Permanently delete a quote. Deleting a quote also deletes every invoice generated from it.
DELETE
https://api.centerfy.ai/webhooks/inbound/quotes/:id Headers
| Header | Required | Value | Description |
|---|---|---|---|
x-api-key | Yes | your sub-account API key (cfy_…) | Authenticates the request; or use Authorization: Bearer <key>. |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string (uuid) | Yes | The quote or estimate id. |
Query parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
force | boolean | No | false | Required when the quote has invoices — they are permanently deleted with it. |
Example
curl -X DELETE "https://api.centerfy.ai/webhooks/inbound/quotes/{id}?force=false" \
-H "x-api-key: $CENTERFY_API_KEY"import { CenterfyClient } from "@centerfy/sdk";
const centerfy = new CenterfyClient({ apiKey: process.env.CENTERFY_API_KEY! });
const result = await centerfy.quotes.delete("<quoteId>", {
"force": "false"
});
console.log(result);centerfy quotes delete <quoteId> '{"force":"false"}'MCP tool: centerfy_quotes_delete (see MCP server)
Response
{
"status": "success",
"deleted": true,
"quote_id": "f2a3b4c5-d6e7-4f8a-9b0c-1d2e3f4a5b6c",
"invoices_deleted": 0
}Errors
409— with invoice_count while the quote has invoices and force is not true.404— if the quote is not in this sub-account.