**`200` Success**
Response body, `application/json`.
| Field | Type | Description |
| --- | --- | --- |
| `status` | string | `success` on every 2xx response. One of: `success` . |
| `data` | object | Labels on one passage of a transcript. |
`data` -- 9 more fields
| Field | Type | Description |
| --- | --- | --- |
| `mediaLabelId` | string | Id of the labelled passage. |
| `mediaId` | string | Id of the media. |
| `labelIds` | string[] | Labels on the passage. |
| `anchor` | object | Where the passage sits in the transcript. Built by the server from the word range you send. |
| `status` | string | `active`: the same words, possibly at new positions after an edit. `shifted`: most of the words survived an edit near the same time, but the text changed. `needs_review`: the words changed too much to follow; `anchor` then holds a suggested passage on the new transcript and `lastResolved` the last position a person confirmed. One of: `active`, `shifted`, `needs_review` . |
| `lastResolved` | object | Present only while `status` is `needs_review`: the last position a person confirmed. |
| `createdAt` | string (date-time) | When it was created. |
| `updatedAt` | string (date-time) | When it last changed. |
| `authorName` | string | The author's display name: the name a share-link viewer wrote as, or the team member's name, or "Team member" when a member has none or has left the company. |
`anchor` -- 9 more fields
| Field | Type | Description |
| --- | --- | --- |
| `startWord` | integer | Position of the first word. |
| `endWord` | integer | Position of the last word, inclusive. |
| `exact` | string | The quoted words, joined by single spaces. |
| `prefix` | string | Up to 32 characters of transcript text before the quote. |
| `suffix` | string | Up to 32 characters of transcript text after the quote. |
| `startInSec` | number | Start time of the first word, in seconds. |
| `endInSec` | number | End time of the last word, in seconds. |
| `speakerIds` | string[] | Speakers of the quoted words. |
| `transcriptRevision` | integer | The transcript revision these positions refer to. |
`lastResolved` -- 9 more fields
| Field | Type | Description |
| --- | --- | --- |
| `startWord` | integer | Position of the first word. |
| `endWord` | integer | Position of the last word, inclusive. |
| `exact` | string | The quoted words, joined by single spaces. |
| `prefix` | string | Up to 32 characters of transcript text before the quote. |
| `suffix` | string | Up to 32 characters of transcript text after the quote. |
| `startInSec` | number | Start time of the first word, in seconds. |
| `endInSec` | number | End time of the last word, in seconds. |
| `speakerIds` | string[] | Speakers of the quoted words. |
| `transcriptRevision` | integer | The transcript revision these positions refer to. |
Example response (Success), `application/json`.
```json
{
"status": "success",
"data": {
"mediaLabelId": "Ml5RtB7nZc2GyQs",
"mediaId": "b4994aa1267c",
"labelIds": [
"Lb3NcY8sDf4HqPe"
],
"anchor": {
"startWord": 42,
"endWord": 49,
"exact": "we need the pricing sheet by Friday",
"prefix": "Before we close the quarter, ",
"suffix": ". Can you send it over?",
"startInSec": 61.4,
"endInSec": 64.2,
"speakerIds": [
"1"
],
"transcriptRevision": 3
},
"status": "active",
"createdAt": "2026-10-06T14:05:12.000Z",
"updatedAt": "2026-10-06T14:05:12.000Z",
"authorName": "Reviewer A"
}
}
```
**`400` Validation, range, label or limit problem**
Response body, `application/json`.
| Field | Type | Description |
| --- | --- | --- |
| `status` | string | `failed`. One of: `failed` . |
| `requestId` | string | Id of this request, for support. |
| `code` | integer | The HTTP status code again. |
| `message` | string | What went wrong, in words you can show to a person. |
| `hints` | string[] | Generic hints for this kind of error. |
Example response (Validation, range, label or limit problem), `application/json`.
```json
{
"status": "failed",
"requestId": "req_0000000000000000",
"code": 400,
"message": "The selected words are outside this transcript.",
"hints": [
"The API request is invalid or improperly formed."
]
}
```
**`404` Any refusal: unknown or revoked token, expired subscription, the setting is off, view mode on a write, media outside the link, a name that is not allowed, or someone else's entry**
Response body, `application/json`.
| Field | Type | Description |
| --- | --- | --- |
| `status` | string | `failed`. One of: `failed` . |
| `requestId` | string | Id of this request, for support. |
| `code` | integer | The HTTP status code again. |
| `message` | string | What went wrong, in words you can show to a person. |
| `hints` | string[] | Generic hints for this kind of error. |
**`409` The transcript changed since you read it**
Response body, `application/json`.
| Field | Type | Description |
| --- | --- | --- |
| `status` | string | `failed`. One of: `failed` . |
| `requestId` | string | Id of this request, for support. |
| `code` | integer | The HTTP status code again. |
| `message` | string | What went wrong, in words you can show to a person. |
| `hints` | string[] | Generic hints for this kind of error. |
Example response (The transcript changed since you read it), `application/json`.
```json
{
"status": "failed",
"requestId": "req_0000000000000000",
"code": 409,
"message": "This transcript changed since you opened it. Reload to keep editing.",
"hints": [
"Please use PUT for update instead of POST",
"The requested operation failed because it tried to create a resource that already exists."
]
}
```
**`429` Rate limit reached**
The spec records this status code with no example body.