---
title: "POST /pricing/versions/{id}/schedule"
method: POST
path: "/pricing/versions/{id}/schedule"
tags: ["Pricing"]
---

# POST /pricing/versions/{id}/schedule

`POST /pricing/versions/{id}/schedule`

Schedule PriceListVersion activation on specified in property 'start_at' time.

## Path parameters

- `id` string, required

## Request body

- object — PriceListVersion representation.
  - `start_at` string, date-time — Time when this PriceListVersion is activated (in case of scheduling activation in future). PriceListVersions are being activated at begin of specified hour.

## Response `200`

- PricingPriceListVersion — PriceListVersion representation.
  - `id` string
  - `description` string, required
  - `base` PricingPriceListVersionReference, required — PriceListVersion representation.
    - `id` string
    - `start_at` string, date-time — Time when this PriceListVersion is activated (in case of scheduling activation in future). PriceListVersions are being activated at begin of specified hour.
  - `start_at` string, date-time — Time when this PriceListVersion is activated (in case of scheduling activation in future). PriceListVersions are being activated at begin of specified hour.
  - `status` 'processing' | 'draft' | 'scheduled' | 'active' | 'obsolete' | 'expired'
  - `pricelist` PricingPriceListRelated — Nested PriceList representation. Fields 'stats.listings' and 'stats.listings_alt' are accessed only by Vendor.
    - `id` string
    - `name` string
    - `currency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BOV' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHE' | 'CHF' | 'CHW' | 'CLF' | 'CLP' | 'CNY' | 'COP' | 'COU' | 'CRC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MXV' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'USN' | 'UYI' | 'UYU' | 'UYW' | 'UZS' | 'VED' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAD' | 'XAF' | 'XAG' | 'XAU' | 'XBA' | 'XBB' | 'XBC' | 'XBD' | 'XCD' | 'XCG' | 'XDR' | 'XOF' | 'XPD' | 'XPF' | 'XPT' | 'XSU' | 'XTS' | 'XUA' | 'XXX' | 'YER' | 'ZAR' | 'ZMW' | 'ZWG'
    - `precision` number — Maximum PricePoints precision. Must be power of -10 (0.1, 0.01, etc.). Each PricePoint will be checked for precision excess.
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated' | 'obsolete'
    - `owner` PricingAccount
      - `id` string
      - `name` string, required
    - `attributes` object[] — PriceList attributes (columns). This is a array of objects. Each object must contain 'name' properties. Property 'description' is optional. Property 'id' is allowed for update only. Property 'name' must match pattern '^(Price|Suggested T0 Price|Suggested T1 Price|Suggested T2 Price|T1 Reseller Real Price|v\.|d\.|vc\..{1:97})$'. At least one attribute must be specified. If specified 'name' and/or 'description' properties for predefined attributes then they will be redefined. Custom attribute names must use the prefix allowed for your role and price list type. Attributes order is equal to XLSX representation column order.
    - `stats` object
      - `products` integer
      - `listings` integer
      - `listings_alt` integer
    - `type` 'flat' | 'volume', nullable
    - `compatibility` 'commerce', nullable
    - `model_type` string
  - `xlsx_file` string, uri-reference, nullable — Link to XLSX representation file.
  - `events` object
    - `activated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `canceled` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `created` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `expired` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `scheduled` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `terminated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `updated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
  - `source_version` PricingPriceListVersionReference — PriceListVersion representation.
    - `id` string
    - `start_at` string, date-time — Time when this PriceListVersion is activated (in case of scheduling activation in future). PriceListVersions are being activated at begin of specified hour.

## Other responses

- `400`

---

[API](https://skmtc.net/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.net/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/revisions/0421d2a97c52/schema)