---
search:
  tags:
    - Product Lists V2
    - PUT
seo:
  description: >-
    Bulk-creates and updates product list rules… Reference for the PUT
    /api/v2/{team_slug}/{app_slug}/product-lists/rules endpoint in the
    Management API v2.
sidebar:
  label: Upsert product list rules
  badge: PUT
title: Upsert product list rules
type: openapi-operation
---
Bulk-creates and updates product list rules grouped per smart product list. Rules are only allowed on smart lists; a rule without id is created, a rule with id is updated.

`PUT /api/v2/{team_slug}/{app_slug}/product-lists/rules`

**Request body** (`application/json`, required)

- `product_lists` (UpsertProductListRulesGroup[], required)

Request body example:

```json
{
  "product_lists": [
    {
      "product_list_id": "0f6ee94d-19db-428e-bfbb-16abab301909",
      "rules": [
        {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "target": "stock",
          "operator": "less-than",
          "target_ids": [
            "497f6eca-6276-4993-bfeb-53cbbbba6f08"
          ],
          "target_stock": 0,
          "target_price_cents": 0,
          "target_is_on_sale": true,
          "store_group_id": "6c760e36-a704-4b09-93bb-c191a46ca67f",
          "market_id": "6364d859-8e1b-477a-bacc-de8305a9292b"
        }
      ]
    }
  ]
}
```

**Responses**

- `200` — OK (partial success possible)
- `400` — Request-level failure
- `401` — Request-level failure
- `403` — Request-level failure
- `500` — Request-level failure

Response example, 200:

```json
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "product_list_id": "0f6ee94d-19db-428e-bfbb-16abab301909",
      "target": "stock",
      "operator": "less-than",
      "target_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "target_stock": 0,
      "target_price_cents": 0,
      "target_is_on_sale": true,
      "store_group_id": "6c760e36-a704-4b09-93bb-c191a46ca67f",
      "market_id": "6364d859-8e1b-477a-bacc-de8305a9292b",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "errors": [
    {
      "product_list_id": "0f6ee94d-19db-428e-bfbb-16abab301909",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "message": "string"
    }
  ]
}
```
