Memo AIDocs
API Reference

Удаление расшифровки

DELETE /transcriptions/{id} — безвозвратно удаляет расшифровку, ее текст, AI-отчеты и сохраненное аудио.

DELETE /transcriptions/{id}

Удаляет одну расшифровку — та же операция, что удаление в приложении. Текст, AI-отчеты и сохраненное медиа исчезают для всех участников workspace.

Необратимо — и закрыто правом ключа

Удаленный контент невозможно восстановить. Эндпоинт доступен только ключам, созданным с опцией Разрешить удаление расшифровок; остальные получают 403 delete_scope_required. Ваша роль в workspace тоже должна позволять удаление — правила те же, что в приложении. См. Аутентификация → Права ключа.

Path-параметры

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

Запрос

curl -X DELETE https://app.memoai.tech/api/v1/developer/transcriptions/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Bearer mk_live_your_key_here"
import httpx

tid = "3fa85f64-5717-4562-b3fc-2c963f66afa6"
resp = httpx.delete(
    f"https://app.memoai.tech/api/v1/developer/transcriptions/{tid}",
    headers={"Authorization": "Bearer mk_live_your_key_here"},
)
resp.raise_for_status()   # 204 No Content
const tid = "3fa85f64-5717-4562-b3fc-2c963f66afa6";
const res = await fetch(
  `https://app.memoai.tech/api/v1/developer/transcriptions/${tid}`,
  {
    method: "DELETE",
    headers: { Authorization: "Bearer mk_live_your_key_here" },
  },
);
if (res.status !== 204) throw new Error(`HTTP ${res.status}`);

Удаление сознательно не вынесено в MCP-инструмент: деструктивная операция не должна быть в одном неверно понятом промпте от выполнения. Используйте REST-эндпоинт из своего кода, где намерение явное.

Ответ

204 No Content — расшифровка удалена. Любое последующее чтение этого id вернет 404, запись исчезнет из списков, экспортов и приложения у всех участников workspace.

Удалять можно в любом статусе: расшифровка в queued или processing останавливается и подчищается, а зарезервированные минуты возвращаются на баланс.

Ошибки

СтатусКогда
401Нет/неверный ключ или ключ передан в URL.
403Ключ без права удаления (delete_scope_required), план без доступа к API или роль в workspace не позволяет удалить эту расшифровку.
404Расшифровки с таким id нет в этом workspace — в том числе уже удаленной.
429Rate limit удалений (30 запросов / минуту на ключ).

Повторный DELETE того же id возвращает 404 — можно считать «уже сделано». Полный справочник — в разделе Ошибки.

На этой странице