---
title: "POST /v1/ai/recordings/:requestId/speakers/:label"
method: POST
path: "/v1/ai/recordings/:requestId/speakers/:label"
tags: ["AI Knowledge"]
---

# POST /v1/ai/recordings/:requestId/speakers/:label

`POST /v1/ai/recordings/:requestId/speakers/:label`

## Request

- Base URL: `https://api.quillhub.ai`
- URL: `https://api.quillhub.ai/v1/ai/recordings/:requestId/speakers/:label`
- Auth: HTTP bearer

## Path parameters

- `requestId` integer, required
- `label` string, required

## Request body

- object
  - `subject_id` integer
  - `name` string
  - `subject_type` string
  - `is_self` boolean
  - `skip` boolean
  - `anonymous` boolean

## Response `200`

Speaker named.

- object
  - `transcript_id` number, required
  - `speaker_label` string, required
  - `subject_id` number, nullable, required
  - `display_name` string, required
  - `enrollment_queued` boolean, required
  - `skipped` boolean
  - `anonymous` boolean
  - `linked_recordings` number, required

## Other responses

- `400`: Bad request.
- `401`: Unauthenticated.
- `403`: Forbidden.
- `404`: Not found.
- `409`: `recording_busy` — a pipeline worker is processing this recording and holds its rows. Retry in a minute; a person created by this request is rolled back, so resending the same body is safe.

---

[API](https://skmtc.dev/quillhub/apis/quillhub-public-api.md) · [All operations](https://skmtc.dev/quillhub/apis/quillhub-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quillhub/apis/quillhub-public-api/revisions/5bd42ee9d967?raw)