---
title: "Get a generated document"
method: GET
path: "/v1/videos/{id}/documents/{documentId}"
tags: ["Videos"]
---

# Get a generated document

`GET /v1/videos/{id}/documents/{documentId}`

## Request

- Base URL: `https://api.tella.com`
- URL: `https://api.tella.com/v1/videos/{id}/documents/{documentId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/videos/:id/documents/:documentId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a document started with POST /v1/videos/{id}/documents: its `status`, and its Markdown `content` once `completed`. Only the API user who started it can read it, for 7 days.

## Path parameters

- `id` string, required: Unique video identifier
- `documentId` string, required: The document ID returned when generation started

## Response `200`

OK

- DocumentResponse
  - `document` Document, required
    - `completedAt` string, date-time, nullable, required
    - `content` string, nullable, required: The document as Markdown once `status` is `completed`, otherwise null. Its first `# ` heading, when present, is the title.
    - `createdAt` string, date-time, required
    - `error` string, nullable, required: Why generation failed, when `status` is `failed`
    - `id` string, required
    - `prompt` string, required
    - `status` 'pending' | 'completed' | 'failed', required: `pending` while the document is being written (usually a few seconds to a minute), then `completed` or `failed`.
    - `videoId` string, required

## Other responses

- `400`: The request was malformed or contained invalid parameters.
- `401`: Authentication is required. Provide a valid API key.
- `403`: You don't have permission to access this resource.
- `404`: The requested resource was not found.
- `409`: The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.
- `429`: You have exceeded the rate limit. Please slow down.
- `500`: An unexpected error occurred
- `501`: The requested operation is not implemented.
- `503`: A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.

## Changes

> 71 revisions in range; 1 not diffed.

- **2026-11-09** `8b204556fec0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/videos/:id/documents/:documentId/get.md)

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) - [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withchima/apis/tella-public-api/revisions/a500b6d75f79?raw)