Get Video Transcript
GET/v2/videos/{video_id}/transcript
Read a video's own transcript, or the transcript attached to it.
transcript=machine (the default) returns the video's own transcript with its speaker labels;
it is empty until that transcript exists. transcript=provider returns what was attached
with PUT, its source, its speaker display names and attached_at, or 404 when nothing
is attached. The response names which transcript it holds in transcript.
The video's owner and administrators can read it; a shared link does not grant access to a transcript.
Request
Responses
- 200
- 401
- 404
- 422
Successful Response
Missing, malformed or rejected credentials — no X-API-Key / Authorization: Bearer <jwt>, an expired token, or a caller that lacks the role the route requires. Note that this API answers authorization failures with 401 as well as 403 (see the 403 entry where a route declares both).
No such resource, or it is not visible to this caller. Ownership failures are reported as 404 rather than 403 so the API does not confirm the existence of another account's records.
Request validation failed. The app flattens FastAPI's validation error list into a single detail string, so the body is {"detail": "'field' <message>"} and NOT FastAPI's default HTTPValidationError. Declaring this overrides the auto-generated 422 — see the module docstring.