tys.garments.update_draft()

Methodtryyoursize

Replace a draft’s content. Published versions never change (409).

def update_draft(garment_id: str, garment: GarmentInput) -> GarmentVersion

Parameters

garment_idstrRequired

The draft's ID.

garmentGarmentInputRequired

Properties

categoryGarmentCategoryRequired

The garment type; it sets which POMs are needed.

fit_intentFitIntentRequired

The designer's intended silhouette; sets the ease targets the fit judgement compares against.

sizesstring[]Required

Size labels, smallest to largest.

pomsPOMTableRequired

Garment measurements per size: size label → POM code → millimetres. Widths are flat half-measurements. See GET /v1/studio/garment_dictionary for codes and plausible ranges.

gradingGradingRuleOptional

How the POM table was derived: the base size's values plus, per POM, the increment (mm) between each pair of consecutive sizes (len = number of sizes - 1). The table stays the source of truth.

fabricFabricRequired

What the tech pack / mill sheet says.

import_idstringOptional

Pattern import linked to this version (omit to unlink).

seasonstringOptional

Season tag, e.g. "SS27".

tolerances_mmTolerancesMMOptional

Spec-sheet tolerance per POM code, ± mm (e.g. {"chest_width": 10}). Optional; the flat preview uses ±5 mm when a POM has none.

spec_sourceSpecSourceOptional

Where the POM table came from, kept for audit. Set by Studio's paste/import.

Returns

GarmentVersion: The updated draft. Published versions never change (409).

Example

PythonNode.jscURL

tys.garments.update_draft(draft["id"], {**garment, "season": "SS27"})  # replaces the draft

await tys.garments.updateDraft(draft.id, { ...garment, season: "SS27" }); // replaces the draft

curl -X PUT https://api.tryyoursize.com/v1/garments/<garment_id> \
  -H "Authorization: Bearer $TRYYOURSIZE_SECRET_KEY" \
  -H "TYS-Version: 2026-10-25" \
  -H "Content-Type: application/json" \
  -d '{"category":"tshirt","fit_intent":"regular","sizes":["S","M","L"],"poms":{"S":{"chest_width":480},"M":{"chest_width":510},"L":{"chest_width":540}},"fabric":{"composition":[{"fiber":"cotton","pct":100}],"weight_gsm":180}}'

See also

• garments.update_draft (HTTP API)