---
title: "Quotes.update"
method: PATCH
path: "/entities/Quotes/{id}"
tags: ["Quote"]
---

# Quotes.update

`PATCH /entities/Quotes/{id}`

Modifies Quote or Quotes with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateQuoteInput
  - `currency_exchange_rates_list_id` string, uuid — Id of the currency exchange rate list applied to this quote.
  - `description` string — Free-form description of the quote.
  - `expiration_date` string, date — Date after which the quote is no longer considered valid.
  - `is_archived` boolean — True when the quote has been archived (lost). Archived quotes remain readable but are hidden from active lists and cannot be edited until reactivated.
  - `name` string — Name of the entity and its default text representation.
  - `oppty_id` string, uuid — Id of the opportunity.
  - `owner_id` string, uuid — Id of the quote owner.
  - `product_currency_id` string, uuid — Id of the product currency.
  - `product_price_list_id` string, uuid — Id of the product price list.
  - `product_sections` object — Product sections grouping the record's line items, as a JSON array of {"id": <UUID>, "name": <string>} objects. Validated on write. Full structure: https://graphql.api-doc.pipelinersales.com/latest/graphql/space/productsection.doc.html
  - `quick_account_email` string — Free-text company email captured at quote creation when no Account record has been linked yet.
  - `quick_account_name` string — Free-text company name captured at quote creation when no Account record has been linked yet.
  - `quick_account_phone` string — Free-text company phone captured at quote creation when no Account record has been linked yet.
  - `quick_contact_name` string — Free-text contact name captured at quote creation when no Contact record has been linked yet.
  - `quick_email` string — Free-text contact email captured at quote creation when no Contact record has been linked yet.
  - `quick_phone` string — Free-text contact phone captured at quote creation when no Contact record has been linked yet.
  - `quote_type_id` string, uuid — Id of the quote type.
  - `reason_of_close_description` string — Free-form note explaining why the quote was archived (lost).
  - `reason_of_close_id` string, uuid — Id of the reason-of-close value.
  - `share_mode` 0 | 1 | 2 | 3 — Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users). The matching sharing_units / sharing_clients lists control who is granted access. Integer enum value: 0 - Standard, 1 - Private, 2 - AllView, 3 - AllEdit
  - `step_id` string, uuid — Id of the quote-process step.
  - `unit_id` string, uuid — Id of the sales unit.
  - `version` integer — Revision number of the quote, incremented when a new version of the same quote is created.
  - `revision` integer — Revision when entity was lastly changed.
  - `total_amount` object — Total monetary value of the quote in the team space base currency, with the foreign value and currency code preserved alongside.
    - `base_value` number, double, required — Currency.
    - `currency_id` string, uuid, required — Relation to single entity instance.
    - `value_foreign` number, double, required — Decimal number.
  - `product_relations` object[] — Product line items on this quote. Each entry holds the product, quantity, price and discount that contribute to total_amount.
    - `id` string, uri
  - `contact_relations` object[] — Contacts linked to this quote.
    - `id` string, uri
  - `account_relations` object[] — Accounts linked to this quote, including the primary-account flag.
    - `id` string, uri
  - `documents` object[] — Documents linked to this quote.
    - `id` string, uri
  - `sharing_units` object[] — Sales units that have been granted shared access to this quote. Editable only when share_mode allows unit sharing.
    - `id` string, uri
  - `sharing_clients` object[] — Users that have been granted shared access to this quote. Editable only when share_mode allows user sharing.
    - `id` string, uri
  - `is_active_in_opportunity` boolean — If quote is set as active in opportunity.
  - `static_profiles` object[] — Saved view profiles this quote currently matches.
    - `id` string, uri
  - `tags` object[] — Tag labels applied to this quote.
    - `id` string, uri

## Response `200`

Modification confirmation. Returns resulting Quote

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` Quote
    - `is_delete_protected` boolean, required — Tells if the entity instance is protected against delete (Entities that need to be present in the system at any time). Delete action still may fail if entity is deletable, due some other additional validations.
    - `id` string, uuid, required — Unique identifier of entity.
    - `is_deleted` boolean — Specifies if the entity is considered deleted.
    - `modified` string, date-time — Last modification time.
    - `created` string, date-time — Creation time.
    - `currency_exchange_rates_list` string, uri — Currency exchange rate list used to convert monetary fields linked to this quote. Empty to inherit the team space default. Relation to CurrencyExchangeRatesList. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'CurrencyExchangeRatesList' object for properties.
    - `oppty` string, uri — Opportunity this quote was prepared for. Empty for standalone quotes. Relation to Opportunity. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Opportunity' object for properties.
    - `owner` string, uri, required — Sales user who owns this quote. Relation to Client. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Client' object for properties.
    - `product_currency` string, uri, required — Currency used for product line-item prices on this quote. Relation to Currency. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Currency' object for properties.
    - `product_price_list` string, uri — Product price list used to populate prices for product line items added to this quote. Empty to use catalog defaults. Relation to ProductPriceList. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'ProductPriceList' object for properties.
    - `quote_type` string, uri, required — Quote type that classifies this quote. Each type maps to one quote process and drives which form, fields and stages apply. Relation to QuoteType. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'QuoteType' object for properties.
    - `reason_of_close` string, uri — Configurable reason recorded when the quote is archived (lost). Required when the lost form mandates it. Relation to Data. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Data' object for properties.
    - `step` string, uri, required — Quote-process step the quote is currently sitting in. Reaching the last step in the process marks the quote as accepted. Relation to Step. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Step' object for properties.
    - `unit` string, uri, required — Sales unit this quote is assigned to. Determines which team members can see the record under unit-based sharing. Relation to SalesUnit. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'SalesUnit' object for properties.
    - `currency_exchange_rates_list_id` string, uuid — Id of the currency exchange rate list applied to this quote.
    - `description` string — Free-form description of the quote.
    - `expiration_date` string, date — Date after which the quote is no longer considered valid.
    - `is_archived` boolean — True when the quote has been archived (lost). Archived quotes remain readable but are hidden from active lists and cannot be edited until reactivated.
    - `name` string, required — Name of the entity and its default text representation.
    - `oppty_id` string, uuid — Id of the opportunity.
    - `owner_id` string, uuid, required — Id of the quote owner.
    - `product_currency_id` string, uuid — Id of the product currency.
    - `product_price_list_id` string, uuid — Id of the product price list.
    - `product_sections` object — Product sections grouping the record's line items, as a JSON array of {"id": <UUID>, "name": <string>} objects. Validated on write. Full structure: https://graphql.api-doc.pipelinersales.com/latest/graphql/space/productsection.doc.html
    - `quick_account_email` string — Free-text company email captured at quote creation when no Account record has been linked yet.
    - `quick_account_name` string — Free-text company name captured at quote creation when no Account record has been linked yet.
    - `quick_account_phone` string — Free-text company phone captured at quote creation when no Account record has been linked yet.
    - `quick_contact_name` string — Free-text contact name captured at quote creation when no Contact record has been linked yet.
    - `quick_email` string — Free-text contact email captured at quote creation when no Contact record has been linked yet.
    - `quick_phone` string — Free-text contact phone captured at quote creation when no Contact record has been linked yet.
    - `quote_number` string — Auto-generated sequential identifier of the quote, used for human-readable reference.
    - `quote_type_id` string, uuid — Id of the quote type.
    - `reason_of_close_description` string — Free-form note explaining why the quote was archived (lost).
    - `reason_of_close_id` string, uuid — Id of the reason-of-close value.
    - `share_mode` 0 | 1 | 2 | 3 — Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users). The matching sharing_units / sharing_clients lists control who is granted access. Integer enum value: 0 - Standard, 1 - Private, 2 - AllView, 3 - AllEdit
    - `step_id` string, uuid, required — Id of the quote-process step.
    - `unit_id` string, uuid — Id of the sales unit.
    - `version` integer — Revision number of the quote, incremented when a new version of the same quote is created.
    - `revision` integer — Revision when entity was lastly changed.
    - `total_amount` object, required — Total monetary value of the quote in the team space base currency, with the foreign value and currency code preserved alongside.
      - `base_value` number, double, required — Currency.
      - `currency_id` string, uuid, required — Relation to single entity instance.
      - `value_foreign` number, double, required — Decimal number.
    - `product_relations` string[] — Product line items on this quote. Each entry holds the product, quantity, price and discount that contribute to total_amount.
    - `primary_contact` string, uri — Primary contact of this quote. Set automatically from the contact relation marked as primary. Relation to Contact. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Contact' object for properties.
    - `primary_account` string, uri — Primary account of this quote. Set automatically from the account relation marked as primary. Relation to Account. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Account' object for properties.
    - `contact_relations` string[] — Contacts linked to this quote.
    - `account_relations` string[] — Accounts linked to this quote, including the primary-account flag.
    - `documents` string[] — Documents linked to this quote.
    - `sharing_units` string[] — Sales units that have been granted shared access to this quote. Editable only when share_mode allows unit sharing.
    - `sharing_clients` string[] — Users that have been granted shared access to this quote. Editable only when share_mode allows user sharing.
    - `status` 1 | 2 | 3, required — Current status of the quote (Open, Lost, Accepted). Read-only; derived from the current step and the archived flag. Integer enum value: 1 - Open, 2 - Lost, 3 - Accepted
    - `formatted_name` string, required — Display version of the quote name, used in lists and references.
    - `is_favorite` boolean, required — True when the current authenticated user has marked this quote as favorite. Per-user.
    - `is_active_in_opportunity` boolean — If quote is set as active in opportunity.
    - `modified_by_user` string, date-time — Timestamp of the most recent modification made by an end user (excluding system changes). Read-only; computed by Coevera.
    - `static_profiles` string[] — Saved view profiles this quote currently matches.
    - `tags` string[] — Tag labels applied to this quote.

## Other responses

- `404` — Sent when invalid ID is given
- `500` — unexpected error

---

[API](https://skmtc.net/aws/apis/pipeliner-cloud-api.md) · [All operations](https://skmtc.net/aws/apis/pipeliner-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pipeliner-cloud-api/versions/e8c12ae60aca/schema)