admin-quotes

Update Quote

Update quote fields such as status, pricing, lead time, and notes.

Status transitions are validated against the allowed transition map.

patch/api/v1/admin/quotes/{quote_id}

Path parameters

quote_idstring uuid required

Request body

statusstring nullable

New quote status (must be a valid QuoteStatus value)

lead_time_daysinteger nullable

Estimated business days until delivery (numeric, used for arithmetic)

lead_time_displaystring nullable

Display override for lead time (e.g. '4-5', '7-10'). Overrides the numeric lead_time_days on the PDF and user-facing quote cards. When unset, the numeric value is rendered instead.

valid_untilstring date-time nullable

Quote expiration timestamp (timezone-aware)

notesstring nullable

Notes visible to the customer

is_human_reviewedboolean nullable

Flag indicating an admin has reviewed this quote

require_depositboolean nullable

Whether a deposit is required before production

customer_name_overridestring nullable

Override for the 'Prepared For' name on the quote PDF. Used when an admin creates a quote on behalf of an end customer. Pass an empty string to clear the override.

customer_email_overridestring nullable

Override for the 'Prepared For' email on the quote PDF. Pass an empty string to clear the override.

customer_billing_address_overridestring nullable

Free-form billing address override for the 'Bill To' block on the quote and invoice PDFs. Multi-line strings (newline-separated) are rendered as-is. Pass an empty string to clear the override and fall back to the order's shipping address / BusinessProfile billing address.

customer_shipping_address_overridestring nullable

Free-form shipping address override for the 'Ship To' block on the quote and invoice PDFs. Multi-line strings (newline-separated) are rendered as-is. Pass an empty string to clear the override and fall back to the project's resolved shipping address.

customer_shipping_name_overridestring nullable

Shipping CONTACT name override for the 'Ship To' block on the quote, invoice, and packing slip PDFs (the receiving dock vs AP-department distinction). Pass an empty string to clear and fall back to customer_name_override, then the project owner's full name.

Response

Successful Response

idstring uuid required
statusstring required
intentstring
total_amountstring nullable
lead_time_daysinteger nullable
lead_time_displaystring nullable
valid_untilstring date-time nullable
notesstring nullable
ai_estimateobject nullable
ai_estimate_generated_atstring date-time nullable
is_human_reviewedboolean required
require_depositboolean
deposit_percentagestring nullable
customer_name_overridestring nullable
customer_email_overridestring nullable
customer_billing_address_overridestring nullable
customer_shipping_address_overridestring nullable
customer_shipping_name_overridestring nullable
reviewed_bystring nullable
reviewed_atstring date-time nullable
tax_amountstring nullable
tax_auto_calculatedstring nullable
tax_ratestring nullable
quote_pdf_urlstring nullable
cost_snapshotobject nullable
pricing_config_versionstring nullable
snapshot_versioninteger
selected_delivery_option_idstring uuid nullable
project_idstring uuid required
created_atstring date-time required
updated_atstring date-time required

Changes

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