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

# ProductPriceLists.update

`PATCH /entities/ProductPriceLists/{id}`

Modifies ProductPriceList or ProductPriceLists with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateProductPriceListInput
  - `description` string — Free-form description of the price list.
  - `end_date` string, date — Date when the price list expires. Empty means open-ended.
  - `is_active` boolean — Master switch for the price list. Inactive price lists are not applied to opportunities or quotes regardless of dates.
  - `name` string — Name of the entity and its default text representation.
  - `rules` object — Filter expression — a FieldFilter JSON object — deciding which records (e.g. accounts, opportunities) the price list applies to. Empty when it applies to all records. Validated on write. Full structure: https://graphql.api-doc.pipelinersales.com/latest/graphql/space/fieldfilter.doc.html
  - `start_date` string, date — Date when the price list becomes active. Empty means immediately.
  - `type` 1 | 2 — Distribution model of the price list (e.g. List, Promotion, Discount). Integer enum value: 1 - Standard, 2 - Scheduled
  - `revision` integer — Revision when entity was lastly changed.
  - `product_price_list_prices` object[] — Per-product, per-currency prices configured in the price list.
    - `id` string, uri

## Response `200`

Modification confirmation. Returns resulting ProductPriceList

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` ProductPriceList
    - `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.
    - `description` string — Free-form description of the price list.
    - `end_date` string, date — Date when the price list expires. Empty means open-ended.
    - `is_active` boolean — Master switch for the price list. Inactive price lists are not applied to opportunities or quotes regardless of dates.
    - `name` string, required — Name of the entity and its default text representation.
    - `rules` object — Filter expression — a FieldFilter JSON object — deciding which records (e.g. accounts, opportunities) the price list applies to. Empty when it applies to all records. Validated on write. Full structure: https://graphql.api-doc.pipelinersales.com/latest/graphql/space/fieldfilter.doc.html
    - `start_date` string, date — Date when the price list becomes active. Empty means immediately.
    - `type` 1 | 2 — Distribution model of the price list (e.g. List, Promotion, Discount). Integer enum value: 1 - Standard, 2 - Scheduled
    - `revision` integer — Revision when entity was lastly changed.
    - `product_price_list_prices` string[] — Per-product, per-currency prices configured in the price list.

## 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)