Bulk Set Prices

curl --request POST \
  --url https://api.merchantops.ai/api/pricing/records/bulk-set-prices \
  --header 'Content-Type: application/json' \
  --data '
{
  "lines": [
    {
      "amount": 123,
      "effective_from": "<string>",
      "price_type": "<string>",
      "batch_key": "<string>"
    }
  ],
  "product_key": "<string>",
  "variant_keys": [
    "<string>"
  ],
  "source": {
    "source_policy_id": "<string>",
    "source": "map_policy",
    "source_style_color_id": "<string>",
    "supersede_record_keys": [
      "<string>"
    ]
  }
}
'

import requests

url = "https://api.merchantops.ai/api/pricing/records/bulk-set-prices"

payload = {
    "lines": [
        {
            "amount": 123,
            "effective_from": "<string>",
            "price_type": "<string>",
            "batch_key": "<string>"
        }
    ],
    "product_key": "<string>",
    "variant_keys": ["<string>"],
    "source": {
        "source_policy_id": "<string>",
        "source": "map_policy",
        "source_style_color_id": "<string>",
        "supersede_record_keys": ["<string>"]
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    lines: [
      {
        amount: 123,
        effective_from: '<string>',
        price_type: '<string>',
        batch_key: '<string>'
      }
    ],
    product_key: '<string>',
    variant_keys: ['<string>'],
    source: {
      source_policy_id: '<string>',
      source: 'map_policy',
      source_style_color_id: '<string>',
      supersede_record_keys: ['<string>']
    }
  })
};

fetch('https://api.merchantops.ai/api/pricing/records/bulk-set-prices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.merchantops.ai/api/pricing/records/bulk-set-prices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'lines' => [
        [
                'amount' => 123,
                'effective_from' => '<string>',
                'price_type' => '<string>',
                'batch_key' => '<string>'
        ]
    ],
    'product_key' => '<string>',
    'variant_keys' => [
        '<string>'
    ],
    'source' => [
        'source_policy_id' => '<string>',
        'source' => 'map_policy',
        'source_style_color_id' => '<string>',
        'supersede_record_keys' => [
                '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.merchantops.ai/api/pricing/records/bulk-set-prices"

	payload := strings.NewReader("{\n  \"lines\": [\n    {\n      \"amount\": 123,\n      \"effective_from\": \"<string>\",\n      \"price_type\": \"<string>\",\n      \"batch_key\": \"<string>\"\n    }\n  ],\n  \"product_key\": \"<string>\",\n  \"variant_keys\": [\n    \"<string>\"\n  ],\n  \"source\": {\n    \"source_policy_id\": \"<string>\",\n    \"source\": \"map_policy\",\n    \"source_style_color_id\": \"<string>\",\n    \"supersede_record_keys\": [\n      \"<string>\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.merchantops.ai/api/pricing/records/bulk-set-prices")
  .header("Content-Type", "application/json")
  .body("{\n  \"lines\": [\n    {\n      \"amount\": 123,\n      \"effective_from\": \"<string>\",\n      \"price_type\": \"<string>\",\n      \"batch_key\": \"<string>\"\n    }\n  ],\n  \"product_key\": \"<string>\",\n  \"variant_keys\": [\n    \"<string>\"\n  ],\n  \"source\": {\n    \"source_policy_id\": \"<string>\",\n    \"source\": \"map_policy\",\n    \"source_style_color_id\": \"<string>\",\n    \"supersede_record_keys\": [\n      \"<string>\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.merchantops.ai/api/pricing/records/bulk-set-prices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"lines\": [\n    {\n      \"amount\": 123,\n      \"effective_from\": \"<string>\",\n      \"price_type\": \"<string>\",\n      \"batch_key\": \"<string>\"\n    }\n  ],\n  \"product_key\": \"<string>\",\n  \"variant_keys\": [\n    \"<string>\"\n  ],\n  \"source\": {\n    \"source_policy_id\": \"<string>\",\n    \"source\": \"map_policy\",\n    \"source_style_color_id\": \"<string>\",\n    \"supersede_record_keys\": [\n      \"<string>\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "ctx": {},
      "input": "<unknown>"
    }
  ]
}

Pricing

Bulk Set Prices

Create several prices at once for a set of variants.

Each line in body.lines becomes one price record per variant, routed to the open batch for its effective date (always ‘auto’ — find-or-create keyed on (org, effective_date)). Lines sharing an effective date coalesce into the SAME batch; different dates land in separate batches. Lines are processed SEQUENTIALLY so same-date lines reuse one batch (no duplicate-batch race). Reuses the exact batch + record + tz logic as mass-create.

When body.source is present (the MAP-policy colorway “Generate Price Changes” flow), every created record is stamped with lineage (source/source_policy_id/source_style_color_id) and a server-recomputed previous_amount (the PER-VARIANT incumbent price at the line’s effective date, or now for a past/today line — same rule as the colorway-prefill diff); the auto-batch path is keyed AND named by the MAP policy instead of the plain date batch; and any record keys the caller confirmed as conflicts are superseded after all lines are created. Without body.source this endpoint’s behavior is unchanged.

POST

api

pricing

records

bulk-set-prices

Bulk Set Prices

curl --request POST \
  --url https://api.merchantops.ai/api/pricing/records/bulk-set-prices \
  --header 'Content-Type: application/json' \
  --data '
{
  "lines": [
    {
      "amount": 123,
      "effective_from": "<string>",
      "price_type": "<string>",
      "batch_key": "<string>"
    }
  ],
  "product_key": "<string>",
  "variant_keys": [
    "<string>"
  ],
  "source": {
    "source_policy_id": "<string>",
    "source": "map_policy",
    "source_style_color_id": "<string>",
    "supersede_record_keys": [
      "<string>"
    ]
  }
}
'

import requests

url = "https://api.merchantops.ai/api/pricing/records/bulk-set-prices"

payload = {
    "lines": [
        {
            "amount": 123,
            "effective_from": "<string>",
            "price_type": "<string>",
            "batch_key": "<string>"
        }
    ],
    "product_key": "<string>",
    "variant_keys": ["<string>"],
    "source": {
        "source_policy_id": "<string>",
        "source": "map_policy",
        "source_style_color_id": "<string>",
        "supersede_record_keys": ["<string>"]
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    lines: [
      {
        amount: 123,
        effective_from: '<string>',
        price_type: '<string>',
        batch_key: '<string>'
      }
    ],
    product_key: '<string>',
    variant_keys: ['<string>'],
    source: {
      source_policy_id: '<string>',
      source: 'map_policy',
      source_style_color_id: '<string>',
      supersede_record_keys: ['<string>']
    }
  })
};

fetch('https://api.merchantops.ai/api/pricing/records/bulk-set-prices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.merchantops.ai/api/pricing/records/bulk-set-prices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'lines' => [
        [
                'amount' => 123,
                'effective_from' => '<string>',
                'price_type' => '<string>',
                'batch_key' => '<string>'
        ]
    ],
    'product_key' => '<string>',
    'variant_keys' => [
        '<string>'
    ],
    'source' => [
        'source_policy_id' => '<string>',
        'source' => 'map_policy',
        'source_style_color_id' => '<string>',
        'supersede_record_keys' => [
                '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.merchantops.ai/api/pricing/records/bulk-set-prices"

	payload := strings.NewReader("{\n  \"lines\": [\n    {\n      \"amount\": 123,\n      \"effective_from\": \"<string>\",\n      \"price_type\": \"<string>\",\n      \"batch_key\": \"<string>\"\n    }\n  ],\n  \"product_key\": \"<string>\",\n  \"variant_keys\": [\n    \"<string>\"\n  ],\n  \"source\": {\n    \"source_policy_id\": \"<string>\",\n    \"source\": \"map_policy\",\n    \"source_style_color_id\": \"<string>\",\n    \"supersede_record_keys\": [\n      \"<string>\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.merchantops.ai/api/pricing/records/bulk-set-prices")
  .header("Content-Type", "application/json")
  .body("{\n  \"lines\": [\n    {\n      \"amount\": 123,\n      \"effective_from\": \"<string>\",\n      \"price_type\": \"<string>\",\n      \"batch_key\": \"<string>\"\n    }\n  ],\n  \"product_key\": \"<string>\",\n  \"variant_keys\": [\n    \"<string>\"\n  ],\n  \"source\": {\n    \"source_policy_id\": \"<string>\",\n    \"source\": \"map_policy\",\n    \"source_style_color_id\": \"<string>\",\n    \"supersede_record_keys\": [\n      \"<string>\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.merchantops.ai/api/pricing/records/bulk-set-prices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"lines\": [\n    {\n      \"amount\": 123,\n      \"effective_from\": \"<string>\",\n      \"price_type\": \"<string>\",\n      \"batch_key\": \"<string>\"\n    }\n  ],\n  \"product_key\": \"<string>\",\n  \"variant_keys\": [\n    \"<string>\"\n  ],\n  \"source\": {\n    \"source_policy_id\": \"<string>\",\n    \"source\": \"map_policy\",\n    \"source_style_color_id\": \"<string>\",\n    \"supersede_record_keys\": [\n      \"<string>\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "ctx": {},
      "input": "<unknown>"
    }
  ]
}

Headers

authorization

string | null

X-Organization-ID

string | null

Cookies

stytch_session

string | null

Body

application/json

Create several prices at once for a set of variants. Each line in lines becomes one price record per variant, batched by effective date (always 'auto' — same rule as mass-create). Lines may repeat a price type (e.g. two sale dates) and may share or differ in effective date.

source is optional and, when present, marks the submission as coming from the MAP-policy colorway flow — see BulkSetPricesSource. Absent source reproduces today's plain manual-entry behavior byte-for-byte.

lines

PriceLine · object[]

required

Minimum array length: 1

Show child attributes

product_key

string

required

variant_keys

string[]

required

source

BulkSetPricesSource · object | null

Present only when the submission came from the MAP-policy colorway "Generate Price Changes" flow (the per-colorway view on the MAP Policy page). Stamps lineage onto every record the submission creates, drives per-variant previous_amount recompute, routes auto-batches to a policy-keyed + policy-named batch instead of the plain date batch, and supersedes any conflicting future records the user confirmed.

Show child attributes

Response

Successful Response

Brands

Catalog

Jobs

Product Lakehouse

MAP Pricing

Pricing

Product Type Categories

Product Types

Products

Variants

Property Definitions

Bulk Set Prices

Headers

Cookies

Body

Response