Batch create variants

POST /v1/materials/variants/batch

Create multiple variants at once All or nothing: if any name collides with an existing variant of the same material, or repeats another name in the request, no variants are created.

Requires: material.create

Request Body

Array of variant data

RequestBody

value

object[]

Example Request

application/json

[
  {
    "name": "string",
    "tags": [
      "string"
    ],
    "materialId": "string"
  }
]

Response Schema

Response

value

object[]

Example Response

201 OK — application/json

[
  {
    "name": "string",
    "materialId": "string",
    "tags": [
      "string"
    ],
    "id": "string",
    "storeId": "string",
    "createdAt": "2026-08-24T03:58:55.644Z",
    "updatedAt": "2026-08-24T03:58:55.644Z"
  }
]