---
title: "POST /api/public/trainees/{traineeId}/labels"
method: POST
path: "/api/public/trainees/{traineeId}/labels"
tags: ["Labels"]
---

# POST /api/public/trainees/{traineeId}/labels

`POST /api/public/trainees/{traineeId}/labels`

Add labels to a trainee. Labels are matched by text and created if new; existing labels can be passed by id.

## Path parameters

- `traineeId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `labels` object[], required
    - `id` string — Existing label id to attach
    - `text` string — Label text; created if new
    - `color` string — Tailwind color key, e.g. "blue-500"

## Response `200`

Successful response

- object — Successful response
  - `data` object

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response
- `429` — Default Response
- `500` — Default Response

---

[API](https://skmtc.dev/coach-platform/apis/coach-platform-api.md) · [All operations](https://skmtc.dev/coach-platform/apis/coach-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coach-platform/coach-platform-api/revisions/63d8b39f710a/schema)