---
title: "Update a quote"
method: PUT
path: "/api/quotes/{quoteId}"
tags: ["Quote"]
---

# Update a quote

`PUT /api/quotes/{quoteId}`

## Path parameters

- `quoteId` string, required

## Request body

- QuoteUpdateDto — Details of quote to be updated
  - `billingAddress` CommonAddressCreateDto — Address with additional context
    - `name` string, nullable — Name of the address (Bob's Shipping, Primary, Reno Warehouse, etc).
    - `address1` string, required — Primary address line.
    - `address2` string, nullable — Second address line.
    - `address3` string, nullable — Third address line.
    - `city` string, required — Address city
    - `stateProvince` string, nullable — Address state/province.
    - `postalCode` string, required — Postal/zip code.
    - `country` string, nullable — Country identifier.
    - `shippingLeadTime` integer, nullable — Lead time for shipping contents.
    - `primaryBilling` boolean — Signifies if this is a primary billing address.
    - `primaryShipping` boolean — Signifies if this is a primary billing address.
    - `email` string, email, nullable — Email address
    - `phone` string, nullable — Associated phone number
    - `fax` string, nullable — Associated fax number
    - `notes` string, nullable — General notes associated to this customer address
  - `externalReferences` object, nullable — Arbitrary key-value-pair like data that can be used to later on search for the Quote
  - `opportunity` string, nullable — CRM Opportunity identifier.
  - `salesPersonId` string, nullable — Sales Person identifier. Please reference /api/users endpoint.
  - `notesToCustomer` string, nullable — A field for the seller to provide additional details or instructions for the customer relating to the order.

## Response `200`

Quote item

- QuoteDto — Represents a Quote
  - `id` string, required — Unique id associated to this entity.
  - `number` integer, required — Number
  - `customerId` string, required — Customer identifier. Please reference /api/customers endpoint.
  - `quotedDate` string, date-time, required — Quoted date (generally the creation date but can be post/pre-dated).
  - `status` 'open' | 'draft' | 'needsApproval' | 'approved' | 'sent' | 'won' | 'lost', required — Quotes status
  - `externalReferences` object, nullable — External references associated with this entity.
  - `totalInPrimaryCurrency` number, double, nullable — The total quote price in local currency of the fulcrum customer
  - `currencyInfo` DomainCurrenciesDocumentCurrencyInfo
    - `id` string, uuid
    - `documentCurrencyCode` string, nullable
    - `primaryCurrencyCode` string, nullable
    - `exchangeRate` number, double
    - `exchangeRateUpdatedOnUtc` string, date-time
    - `exchangeRateError` string, nullable
  - `customFields` object, nullable — Custom fields that have been defined for the quote;
  - `opportunity` string, nullable — CRM Opportunity identifier.
  - `salesPersonId` string, nullable — Unique identifier of the sales person attached to this sales order. Please reference /api/users endpoints.
  - `billingAddress` CommonAddressDto — Address definition
    - `name` string, nullable — Name of the address (Bob's Shipping, Primary, Reno Warehouse, etc).
    - `address1` string, required — Primary address line.
    - `address2` string, nullable — Second address line.
    - `address3` string, nullable — Third address line.
    - `city` string, required — Address city
    - `stateProvince` string, nullable — Address state/province.
    - `postalCode` string, required — Postal/zip code.
    - `country` string, nullable — Country identifier.
    - `phone` string, tel, nullable — Phone number.
    - `email` string, email, nullable — Email address
  - `shippingAddresses` CommonAddressDto[], nullable — The customer address(es) that the quote contents should be shipped to.
    - `name` string, nullable — Name of the address (Bob's Shipping, Primary, Reno Warehouse, etc).
    - `address1` string, required — Primary address line.
    - `address2` string, nullable — Second address line.
    - `address3` string, nullable — Third address line.
    - `city` string, required — Address city
    - `stateProvince` string, nullable — Address state/province.
    - `postalCode` string, required — Postal/zip code.
    - `country` string, nullable — Country identifier.
    - `phone` string, tel, nullable — Phone number.
    - `email` string, email, nullable — Email address
  - `companyId` string, nullable — Company identifier. Please reference /api/companies endpoint.
  - `paymentTermsId` string, nullable — Payment terms key identifier. Please reference /api/payment-terms endpoint.
  - `paymentTerms` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `createdUtc` string, date-time, required — Date this record was created (UTC).
  - `notesToCustomer` string, nullable — A field for the seller to provide additional details or instructions for the customer relating to the order.

## Other responses

- `404` — Quote did not exist

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)