Printago API
POST /v1/materials/parts/{partId}/assignments

Assign material to part

Assign a material to a part's filament channel

Requires: material.edit

Path Parameters

partId required
string
Part ID

Request Body

Assignment data with material/variant/group and channel index

PartMaterialAssignmentInsert
groupIdrequirednullable
string
pattern: ^[a-z0-9]{24}$
indexrequired
number
min: 0
materialIdrequirednullable
string
pattern: ^[a-z0-9]{24}$
materialTyperequirednullable
string
partIdrequired
string
pattern: ^[a-z0-9]{24}$
priorityrequired
number
min: 0
variantIdrequirednullable
string
pattern: ^[a-z0-9]{24}$

Example Request

application/json 
{
  "partId": "string",
  "priority": 0,
  "groupId": "string",
  "materialId": "string",
  "variantId": "string",
  "materialType": "string",
  "index": 0
}

Response Schema

PartMaterialAssignment
createdAtrequired
string
format: date-time
groupIdrequirednullable
string
pattern: ^[a-z0-9]{24}$
idrequired
string
pattern: ^[a-z0-9]{24}$
indexrequired
number
min: 0
materialIdrequirednullable
string
pattern: ^[a-z0-9]{24}$
materialTyperequirednullable
string
partIdrequired
string
pattern: ^[a-z0-9]{24}$
priorityrequired
number
min: 0
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
updatedAtrequired
string
format: date-time
variantIdrequirednullable
string
pattern: ^[a-z0-9]{24}$

Example Response

201 OK — application/json 
{
  "id": "string",
  "storeId": "string",
  "createdAt": "2025-01-15T12:00:00.000Z",
  "updatedAt": "2025-01-15T12:00:00.000Z",
  "groupId": "string",
  "variantId": "string",
  "materialId": "string",
  "materialType": "string",
  "partId": "string",
  "index": 0,
  "priority": 0
}