Изменение расшифровки

PATCH /transcriptions/{id} — сменить владельца расшифровки после загрузки.

PATCH /transcriptions/{id}

Переназначает расшифровку другому участнику workspace. Пока единственное поле — author; формат тот же <type>:<value>, что у заголовка X-Author при загрузке — см. Назначение автора.

Пригодится, когда автор не был известен при загрузке — не хватало маппинга в CRM, менеджер еще не вступил в workspace — и нужно поправить принадлежность без повторной загрузки. Нужен ключ с опцией Разрешить загрузку файлов (иначе 403 upload_scope_required).

Path-параметры

Параметр	Тип	Описание
`id`	UUID	Идентификатор расшифровки — из списка или ответа загрузки.

Тело

Поле	Тип	Описание
`author`	string \| null	`email:name@company.com` или `user:<uuid>` — активный участник workspace. `null` возвращает расшифровку создателю ключа.

Запрос

curl -X PATCH https://app.memoai.tech/api/v1/developer/transcriptions/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Bearer mk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"author": "email:ivanov@company.com"}'

import httpx

tid = "3fa85f64-5717-4562-b3fc-2c963f66afa6"
resp = httpx.patch(
    f"https://app.memoai.tech/api/v1/developer/transcriptions/{tid}",
    headers={"Authorization": "Bearer mk_live_your_key_here"},
    json={"author": "email:ivanov@company.com"},
)
resp.raise_for_status()
print(resp.json()["author"])   # {"id": "9c2d4e6f-1a2b-4c3d-8e9f-0a1b2c3d4e5f", "email": "ivanov@company.com", "name": "Иван Иванов"}

const tid = "3fa85f64-5717-4562-b3fc-2c963f66afa6";
const res = await fetch(
  `https://app.memoai.tech/api/v1/developer/transcriptions/${tid}`,
  {
    method: "PATCH",
    headers: {
      Authorization: "Bearer mk_live_your_key_here",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ author: "email:ivanov@company.com" }),
  },
);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { author } = await res.json();

Ответ

200 OK с полной расшифровкой — то же тело, что у Получения расшифровки, — с обновленным author.

Работает в любом статусе. Если переназначить расшифровку в статусе queued или processing, уведомление о готовности получит новый автор, и она появится в его списке, как только завершится.

Кто может переназначать

Создателю ключа нужны права на редактирование расшифровки — те же, что в приложении: свои расшифровки, расшифровки в проектах, где он редактор или владелец, или все — для владельца workspace.
Ключ всегда может переназначать расшифровки, которые загрузил сам, даже после того как отдал их другому.

Ошибки

Статус	Код	Когда
`403`	`upload_scope_required`	У ключа нет права загрузки.
`403`	`author_requires_api_key`	Вызов с OAuth-токеном вместо API-ключа.
`403`	—	У создателя ключа нет прав на редактирование этой расшифровки.
`404`	—	Неизвестный id или расшифровка из другого workspace.
`422`	`invalid_author` / `unsupported_author_type` / `author_not_member`	Правила те же, что у `X-Author` при загрузке — см. Назначение автора.