transcript.imDocs
DocumentationAPI Reference

Remove transcript

DELETE
/v1/library/transcripts/{platform}/{externalId}

Removes the owner's library/extraction rows for this asset, including a failed-history row that has no transcript body; the global cache is retained. Omit language to remove the owner's latest saved or failed language. Owner-scoped: another account's asset is a 404. Removal is permanent — a dismissed failure never reappears.

AuthorizationBearer <token>

Session token (cookie-based auth in browser) or developer API key (tr_ prefix). API keys require the transcripts scope for /v1/transcript and the batches scope for /v1/batch.

In: header

Path Parameters

platform*string

Value in

  • "youtube"
  • "tiktok"
  • "instagram"
  • "upload"
  • "linkedin"
  • "twitter"
externalId*string

Query Parameters

language?string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/library/transcripts/youtube/string"
{  "removed": true}