Update quote status

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

Transition a quote between lifecycle states. The endpoint accepts draft, sent, accepted, and declined as targets, and the server enforces the transition table (see Lifecycle): an illegal transition is rejected. In practice no legal transition targets draft, and converted is reachable only through the convert endpoint.

Writes an audit record on success.

Path parameters

idstringrequired

Body parameters

statusstringrequired

New status. Convert to invoice uses POST /:id/convert.

draftsentaccepteddeclined

Response

200Quote status updated.

Show response fields

statusstring

Error codes

400Illegal status transition.

404Quote not found.

RequestPATCH/v1/quotes/{id}/statuscurl

curl -X PATCH https://api.speybooks.com/v1/quotes/quo_42/status \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"status": "accepted"}'

Response200

{
  "success": true,
  "data": {
    "status": "accepted"
  }
}