Skip to main content
PATCH
Tenant credential
Required scopes: quotes.write.

Authorizations

X-API-Key
string
header
required

Tenant credential. This is sufficient by itself.

Headers

X-PrintTools-Organization-Id
string<uuid>

Tenant credential: optional and, when sent, must equal the shop bound to the key. Partner credential: required; it selects an organisation the user previously authorised.

Idempotency-Key
string

Optional client-generated key for write retries. Reusing it with a different request returns 409; a replay includes Idempotency-Replayed: true.

Required string length: 1 - 200

Path Parameters

decorationId
string<uuid>
required

UUID.

Example:

"11111111-2222-3333-4444-555555555555"

Body

application/json
decorationItemId
string
method
enum<string>
Available options:
ScreenPrinting,
Embroidery,
DtfTransfer,
Dtg,
Vinyl,
Sublimation,
HeatTransfer,
Outsourced,
Other
position
string
quantity
integer
setupCost
number
unitCost
number
baseUnitCost
number
baseSetupCost
number
includeSetupCost
boolean
markupType
enum<string>

The per-unit markup as saved — see QuoteGroupDecoration.markupType.

Available options:
percentage,
flat_rate
markupValue
number
markupSource
enum<string>

Omitted → manual. A group-resolved markup must send group explicitly (AC 12).

Available options:
group,
manual
setupMarkupType
enum<string>

The setup lane's own markup — see QuoteGroupDecoration.setupMarkupType.

Available options:
percentage,
flat_rate
setupMarkupValue
number
setupMarkupSource
enum<string>

Omitted → manual, as for markupSource.

Available options:
group,
manual
rollUp
boolean

Fold this decoration's unit charge into the garment price — see QuoteGroupDecoration.rollUp.

rollUpSetup
boolean

Fold its setup charge. Inert unless includeSetupCost.

showOnDocuments
boolean

Draw the row on customer-facing documents. Defaults true.

description
string
widthCm
number

Centimetres — see QuoteGroupDecoration.widthCm.

lengthCm
number
necklineDropCm
number
screenCount
integer
screenMeshGrade
string
colourCount
integer
colours
object[]

Replaces the whole list. At most one entry keeps isBase — see DecorationColour.

specialInstructions
string

Internal only — see QuoteGroupDecoration.specialInstructions.

artworkFileUrl
string
separationFileUrl
string
sortOrder
integer

Response

Successful response.

Every 2xx response uses this envelope.

status
boolean
required

The actual resolver result. It can be false when an operation returns false or null without throwing.

message
string
required
Example:

"OK"

data
object
required