BillOS v1
Console llms.txt OpenAPI
POST/businesses/{bid}/quotes/{id}/cancel

Withdraw a quote

POST /businesses/{bid}/quotes/{id}/cancel

Requires the documents scope.

The public link stops answering (the token is cleared, not kept: a withdrawn offer whose link still renders it is the customer's evidence that it stood). The row and its history stay, and reopen puts it back.

Path parameters

NameTypeDescription
bidstringrequiredBusiness id, from POST /businesses.
idstringrequiredQuote id.

Response

200: { "ok": true, … }

FieldTypeDescription
okbooleanrequired
quoteQuoterequiredהצעת מחיר: an OFFER, and deliberately not a document: it carries no statutory number, it is freely editable and deletable, and it appears in no export, no VAT return and no income report. What it becomes when the customer accepts is an ordinary draft document (POST .../convert).

Errors: 400, 401, 403, 404, 429. Every failure answers { "error", "reason", "hint", "param", "doc_url", "retryable", "request_id" }: branch on reason, and read hint for what to change (https://docs.billos.co.il/errors.md).

PreviousRecord the customer's answer NextReopen a quote
On this page
Path parametersResponse
POST /businesses/{bid}/quotes/{id}/cancel 
curl -X POST "$BASE/businesses/$BID/quotes/$DOC_ID/cancel" \
  -H "X-Api-Key: $KEY"
const res = await fetch(`${BASE}/businesses/${BID}/quotes/${DOC_ID}/cancel`, {
  method: 'POST',
  headers: {
    'X-Api-Key': KEY,
  },
})
const data = await res.json()
if (!data.ok) throw new Error(data.reason)
import requests
res = requests.post(
    f"{BASE}/businesses/{BID}/quotes/{DOC_ID}/cancel",
    headers={"X-Api-Key": KEY},
)
data = res.json()
Set BASE to https://api.billos.co.il/v1 and KEY to your bk_live_… key, or a bk_test_… key to run it against the sandbox.
Manage your businesses, keys and webhooks in the BillOS Console.