Update variant

PATCH /v1/materials/variants/{id}

Update a variant's properties Renaming onto another variant of the same material returns 409 Conflict.

Requires: material.edit

Path Parameters

id required

string

Variant ID

Request Body

Fields to update

PartialMaterialVariant

coloroptional

string

createdAtoptional

string

format: date-time

externalIdoptional

string

filamentSystemProfileIdoptional

number

filamentUserProfileIdoptional

string

idoptional

string

pattern: ^[a-z0-9]{24}$

materialIdoptional

string

pattern: ^[a-z0-9]{24}$

nameoptional

string

pressureAdvanceoptional

number

pricePer1000goptional

number

sourceoptional

string

storeIdoptional

string

pattern: ^[a-z0-9]{24}$

tagsoptional

string[]

updatedAtoptional

string

format: date-time

Example Request

application/json

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

Response Schema

MaterialVariant

colorrequired

string

createdAtrequired

string

format: date-time

externalIdoptional

string

filamentSystemProfileIdrequired

number

filamentUserProfileIdrequired

string

idrequired

string

pattern: ^[a-z0-9]{24}$

materialIdrequired

string

pattern: ^[a-z0-9]{24}$

namerequired

string

pressureAdvanceoptional

number

pricePer1000goptional

number

sourceoptional

string

storeIdrequired

string

pattern: ^[a-z0-9]{24}$

tagsrequired

string[]

updatedAtrequired

string

format: date-time

Example Response

200 OK — application/json

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