Patch Quote

Updates a draft quote. Only draft quotes can be changed; a published
quote returns 409.

Every field is three-state: omit a key to keep the stored value, send
null to clear it, or send a value to write it. name,
currency_iso, owner, contact, recurring_interval,
billing_address and billing_address.country_code cannot be cleared
and reject null with 422. Unknown fields are rejected with 422.

tax_codes and content_blocks are full replacements: the array
you send becomes the new set. Replacing tax_codes recalculates the
quote.

The contact is identified by email plus either client_id or
client_name; when both are provided, client_id is used. A contact
that does not exist is created; with client_name that requires
first_name and last_name.

Contact details and billing_address are recorded on this quote and
saved to the contact; other quotes keep the details they were created
with. Send them with contact to
re-point the quote at a different person, or without it to correct the
contact the quote already names. Omitted details carry the contact's
current values forward. Supplying any of them requires a billing
address country, either in this request or on the contact.

Response body matches GET /v1/quotes/{quote_id}.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Quote ID.

Body Params

Fields to change on a quote. Every field is optional. Omit a key to
preserve the stored value, send null to clear it, or send a value to
write it.

billing_address
object

Billing address recorded on this quote and saved to the contact.
Only the fields you send change; the rest keep their stored value. The
address cannot be cleared, so null returns 422.

string | null

Internal sales notes attached to the quote. Plain text.

contact
object

Replaces the quote's primary billing contact. Reference an existing
client with client_id, or resolve one by the client_name plus
email pair. The detail fields are recorded on this quote and
saved to the contact. The object cannot be cleared; null
returns 422.

content_blocks
object | null

Replaces the quote's content blocks wholesale. The object you send
becomes the new set, so an absent closing key clears the closing
blocks. Detaches from this quote only; the account's shared
content-block library is never deleted.

cover_page
object | null

Updates the cover page. Each field inside it is optional: an
omitted field is left as is, null clears it, and a value
replaces it. show_header_footer cannot be cleared, so null
returns 422. cover_page: null clears the whole cover page.

string | null
deprecated

Deprecated. Accepted until 2027-11-30. Use
cover_page.content instead. Sending cover_page together with any
cover_page_* field returns 422.

HTML body for the quote cover page.

string | null
deprecated

Deprecated. Accepted until 2027-11-30. Use
cover_page.subtitle instead. Sending cover_page together with any
cover_page_* field returns 422.

Cover page subtitle. Max 125 characters.

string | null
deprecated

Deprecated. Accepted until 2027-11-30. Use
cover_page.title instead. Sending cover_page together with any
cover_page_* field returns 422.

Cover page title. Max 100 characters.

string

ISO 4217 currency code (3 letters). Declares which currency the
quote's amounts are expressed in; it performs no conversion and
does not reprice existing line items. Cannot be cleared.

string | null

Caller-supplied quote number override. Max 250 characters.

date-time | null

Quote expiration date, as an RFC 3339 UTC timestamp with second
precision. Must not be in the past.
Cleared to null, the account's default expiration window applies
at publish time.

string | null

Initiative the quote belongs to. Max 50 characters. Send null to
clear the link.

integration
object | null

PSA record the quote is linked to. Send null to clear the link.
{} returns 422.

string | null

Private notes on the quote, not shown to the contact.

string
length ≤ 75

Quote display name. Max 75 characters. Cannot be cleared.

owner
object

Reassigns the quote to another user by email. The caller needs
elevated access to set this; a caller without it receives
ERR_OWNER_EMAIL_NOT_PERMITTED.

string
enum

Billing interval shared by every recurring line item on the quote.
Changing it moves the quote's existing recurring line items onto the
new interval, and recurring line items added later must use it.
Cannot be cleared.

Allowed:
tax_codes
array of objects | null

Replaces the quote's tax codes wholesale. The array you send becomes
the new set; null or an empty array removes them all. Changing
them recalculates the quote.

tax_codes
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json