---
title: "Upload Colourway Swatch"
method: POST
path: "/questionnaires/jobs/{job_id}/colourway-swatch"
tags: ["questionnaires"]
---

# Upload Colourway Swatch

`POST /questionnaires/jobs/{job_id}/colourway-swatch`

## Request

- Base URL: `https://api.threadchain.pro` (the document declares no server; this is the origin it was published from)
- URL: `https://api.threadchain.pro/questionnaires/jobs/{job_id}/colourway-swatch`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

Save a colourway swatch from the colour picker (hex) and/or an uploaded image to Backblaze B2.

Updates ``platform_payload.colourwaySwatchHexByKey`` and ``colourwaySwatchImageByKey``.

## Path parameters

- `job_id` string, uuid, required

## Request body `multipart/form-data`

- BodyUploadColourwaySwatchQuestionnairesJobsJobIdColourwaySwatchPost
  - `swatch_key` string, required: UI key e.g. 0-17-5104 TCX (colourway index + Pantone code)
  - `hex` string, nullable: Picker hex e.g. #2D5A4A — generates a swatch PNG on B2
  - `file` string, binary, nullable: Optional swatch reference image (PNG/JPEG/WebP)
  - `type` string: 'colourway' or 'pattern'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/threadchain/apis/threadchain-backend.md) - [All operations](https://skmtc.dev/threadchain/apis/threadchain-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/threadchain/apis/threadchain-backend/revisions/8ee288a7e6bd?raw)