Update a draft quote

PUThttps://app.speybooks.com/api/v1/quotes/{id}

Replace a draft quote. Only quotes in draft status can be modified; sent, accepted, declined, and converted quotes are immutable.

This is a full replacement, not a partial update: contactId, issueDate, validUntil, and lines are required on every request, existing lines are deleted and replaced with the new set, and totals are recomputed. A quote that does not exist or is not in draft status is rejected.

Path parameters

idstringrequired

Body parameters

contactIdstringrequired

issueDatestringrequired

linesarray<object>required

Show child parameters

descriptionstringrequired

quantitystringrequired

unitPricestringrequired

vatRateintegerrequired

min: 0 · max: 100

accountIdstringoptional

validUntilstringrequired

notesstringoptional

referencestringoptional

Response

200Quote updated.

Show response fields

quoteNumberstring

Error codes

400Quote is not in draft status.

404Quote not found.

RequestPUT/v1/quotes/{id}curl

curl -X PUT https://api.speybooks.com/v1/quotes/quo_42 \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "contactId": "cont_3",
    "issueDate": "2026-06-01",
    "validUntil": "2026-07-01",
    "notes": "Updated scope to include Phase 2",
    "lines": [{
      "description": "API Integration - Phases 1 and 2",
      "quantity": "1",
      "unitPrice": "2500.00",
      "vatRate": 20,
      "accountId": "acc_4000"
    }]
  }'

Response200

{
  "success": true,
  "data": {
    "quoteNumber": "QT-0007"
  }
}