POST /api/style-variants/ – Retraced API Reference

Admin9

Administration/Allowed Origins6

Administration/API-Keys3

Administration/Attachment Templates6

Administration/Audit Types5

Administration/Audits1

Administration/Badges1

Administration/Certification Rules4

Administration/Claims15

Administration/Classification Data Fields3

Administration/Classification Impact Areas5

Administration/Collaboration Statuses4

Administration/Companies14

Administration/Companies/Templates1

Administration/Company Documents3

Administration/Custom Information Fields5

Administration/Development Tags2

Administration/Document Types6

Administration/Facility Processes4

Administration/Fiber13

Administration/Files6

Administration/Materials5

Administration/Network Onboarding8

Administration/Platform Features4

Administration/Product Categories5

Administration/Product Category Fields5

Administration/Production Processes3

Administration/Questionnaire Templates17

Administration/Relationship Types3

Administration/SLCP1

Administration/Standards2

Administration/Styles1

Administration/Supply Chains2

Administration/Tag Identifications3

Administration/Tracing AI1

Administration/User Companies5

Administration/Users13

Administration/UX Configs3

Administration/Webshops6

Agent2

AI Extraction Feedback1

AI Feedback1

AI Processing Status4

API-Keys3

Assets1

Attachment Templates10

Audit findings3

Audit Types1

Audits14

Authentication19

Automation Rules13

Badges2

CAPA25

CAPA Actions15

CAPA Findings9

Certificate AI4

Certifications1

CertifiedMaterials/AI4

CertifiedMaterials/Companies3

CertifiedMaterials/Documents9

CertifiedMaterials/Evidence2

CertifiedMaterials/FieldMatching6

CertifiedMaterials/FilterOptions1

CertifiedMaterials/Orders12

CertifiedMaterials/Products1

CertifiedMaterials/Requests7

CertifiedMaterials/Users1

Claims18

Companies31

Companies/Data Point Answers1

Companies/Impact Areas1

Companies/Templates4

Company Certifications1

Company Documents16

Company Profiles1

CompanyProfilesUnlink2

Constants Mapping/Facility processes4

Constants Mapping/Materials4

Constants Mapping/Product types4

Dashboard Analytics/Audits Drill Down1

Dashboard Analytics/Audits Metrics3

Dashboard Analytics/Certification Drill Down1

Dashboard Analytics/Certification Metrics3

Dashboard Analytics/Tracing Documents2

Dashboard Analytics/Tracing Metrics2

Document Types1

Entity Screening3

Entity Tags4

Entity Tags Links1

entity-screening3

Facility Processes1

Files5

Help articles1

Impact Areas2

Integrations - Amfori12

Materials1

Natural languages to Automation Rules1

Notifications3

Order Documents2

Order Lines2

Order Tracing - Calculations2

Order Tracing - Documents5

Order Tracing - Internal Orders1

Order Tracing - Order Lines1

Order Tracing - Orders11

Order Tracing - Purchase Orders14

Order Tracing - Sales Orders11

Order Tracing - Trace8

Orders21

OrderTracing - Transactions21

Permissions25

Product Categories3

Product Mapping23

Product Mapping - Communications4

Product Placements2

Product Properties2

Products1

Products - Styles1

Products/Badges3

Products/Batches8

Products/BOM-Headers5

Products/BOM-Import1

Products/BOM-Lines4

Products/BOM-Placements3

Products/Cascade-Tracing1

Products/Certifications1

Products/DPP1

Products/Exports1

Products/Map2

Products/Material-Headers5

Products/Material-Lines4

Products/StyleProperties2

Products/Styles9

Products/StyleTypeFieldValues2

Products/StyleTypes1

Products/Variant-SKUs6

Products/Variants6

Profile4

Questionnaire17

Questionnaire Comments4

Questionnaire request8

Questionnaire Responses7

Risk Analysis51

SLCP16

Standards3

Status1

StyleLinks1

Styles/Documents10

Styles/OrderDocuments2

Supplier Statistics4

Supply Chains37

System/Cache1

System/Emails3

System/Files1

System/QueueJobs3

Terms and Conditions1

Tracing AI6

User Companies2

Users8

Webshop16

Products/Variants

Changed on Oct 8, 2026

post/api/style-variants/

Request

Base URL
https://api.retraced.com (the document declares no server; this is the origin it was published from)
URL
https://api.retraced.com/api/style-variants/
Auth
none declared

Request body

forCompanyIdstring

styleIdstring required

namestring required

descriptionstring nullable

colorstring required

genderstring nullable

imagesFileIdsstring[] nullable

brandsstring[] nullable

departmentsstring[] nullable

seasonsstring[] nullable

collectionsstring[] nullable

customPropertiesstring[] nullable

Array of style property IDs of category 'customProperties'. Values must be created via POST /style-properties before use.

suppliersstring[] nullable

mainSupplierstring nullable

vendorsstring[] nullable

claimIntentionsstring[] nullable

isStoryActiveboolean

externalIdstring

Your own identifier for this product. Unique per company across all product levels. Can be used in place of the Retraced ID on any product ID field in this API. On update it is only written when the field is present in the body — omitting it keeps the stored value, sending null clears it.

Response

Default Response

Changes

Oct 8, 2026b868e4fcab3c Revision changes
- breaking
  the request property type changed from string to array
- breaking
  response property data/customProperties list-of-types was widened by adding types array and null to media type application/json of response 201
Aug 31, 202697e51f27dc77 Revision changes
- breaking
  added the new required request property /
- breaking
  added the new required request property /
- breaking
  removed subschema #1 subschema #2 from the request property anyOf list
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  the request property's minLength was increased from 0 to 1
- breaking
  the request property type changed from no type to object
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property /// became nullable for the status
- warning
  the request property's maxLength was set to 4000
- warning
  the request property's maxLength was set to 50
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  response property data/customProperties list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/externalId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/contentType list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/createdBy list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/createdByApiKeyId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/createdByApiKeyLabel list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/createdByCompanyId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/createdByImpersonateId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/createdByImpersonateName list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/createdByUserId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/fileHash list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/fileSize list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/fileType list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/previewUrl list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/updatedByApiKeyId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/updatedByApiKeyLabel list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/updatedByCompanyId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/updatedByCompanyName list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/updatedByImpersonateId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/updatedByImpersonateName list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/updatedByUserId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/updatedByUserName list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/featuredImage/anyOf[subschema #1]/url list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/contentType list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/createdBy list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/createdByApiKeyId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/createdByApiKeyLabel list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/createdByCompanyId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/createdByImpersonateId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/createdByImpersonateName list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/createdByUserId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/fileHash list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/fileSize list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/fileType list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/updatedByApiKeyId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/updatedByApiKeyLabel list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/updatedByCompanyId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/updatedByCompanyName list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/updatedByImpersonateId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/updatedByImpersonateName list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/updatedByUserId list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/updatedByUserName list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/images/items/url list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/isComponent list-of-types was narrowed by removing types number from media type application/json of response 201
- info
  response property data/isStoryActive list-of-types was narrowed by removing types number from media type application/json of response 201
- info
  response property data/qrCodeUrl list-of-types was narrowed by removing types null from media type application/json of response 201
- info
  response property data/tracingStory/anyOf[subschema #1]/tracingName list-of-types was narrowed by removing types null from media type application/json of response 201

Operation history

Request

Request body

Response 201Created

Changes

Response