# NewStyleInput

input type

Create-input for a Style. The tenant (org group) is derived SERVER-SIDE from the principal — NEVER supplied here; styleType is REQUIRED (all four types accepted — the refusal lifted) and immutable; every referenced construct (scheme groups / brand / seasons / placement categories \[LEAF-only] / tags / characteristics \[value-validated]) is tenant-scoped server-side and must be ACTIVE.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional: when omitted the per-type default applies — the merchant code when given, else 'Style'; when supplied it must be non-blank. |
| `styleType` | [StyleType](/types/StyleType/) `StyleType!` | yes | The style kind — immutable after birth; all four types accepted. |
| `scheme` | [StyleSchemeEntryInput](/types/StyleSchemeEntryInput/) `[StyleSchemeEntryInput!]` | no | The ORDERED option dimensions (at most 8, unique groups; tier defaulted for color/size, REQUIRED for custom). |
| `brandId` | [ID](/types/#scalars) | no | The optional Brand — tenant-scoped server-side, must be active. |
| `sizeRunId` | [ID](/types/#scalars) | no | The optional SizeRun — tenant-scoped server-side, must be ACTIVE and over a group in the scheme. |
| `seasonIds` | [ID](/types/#scalars) `[ID!]` | no | Season memberships (at most 32, unique) — each tenant-scoped + active. |
| `categoryPlacements` | [StylePlacementEntryInput](/types/StylePlacementEntryInput/) `[StylePlacementEntryInput!]` | no | Category placements (at most 32, unique, at most 1 primary) — each target tenant-scoped + active + a LEAF. |
| `tagIds` | [ID](/types/#scalars) `[ID!]` | no | The Tag set (at most 64, unique) — each tenant-scoped + active. |
| `characteristicEntries` | [StyleCharacteristicEntryInput](/types/StyleCharacteristicEntryInput/) `[StyleCharacteristicEntryInput!]` | no | Characteristic values (at most 64, unique per characteristic) — each target tenant-scoped + active; values validated per valueType/grammar. |
| `code` | [String](/types/#scalars) | no | No further notes. |
| `taxCategory` | [TaxCategory](/types/TaxCategory/) | no | The tax classification — ABSENT = standard (the default). |

## Used by

- [createStyle](/reference/style/createStyle/)