MediaGet a file

Get a file

Returns one file from the media library.

curl -X GET "https://api.documentationai.app/api/v1/media/123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "media": {
    "id": "4c1d8a2e-7b3f-4f0a-9d6e-2a5b8c7e1f03",
    "name": "setup-diagram.png",
    "kind": "image",
    "mimeType": "image/png",
    "sizeBytes": 184233,
    "url": "https://blob-cdn.documentation.ai/.../setup-diagram.png",
    "altText": "Setup steps diagram",
    "width": 1440,
    "height": 900,
    "durationSeconds": 42,
    "pageCount": 25,
    "posterUrl": "example_string",
    "createdAt": "2026-09-17T10:00:00.000Z",
    "updatedAt": "2026-09-17T10:00:00.000Z",
    "snippet": "<Image src="https://blob-cdn.documentation.ai/.../setup-diagram.png" alt="Setup steps diagram" />"
  }
}
GET
/media/{mediaId}
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

API key generated from the Documentation.AI dashboard (Settings → API Keys). Pass as Authorization: Bearer dai_...

API key generated from the Documentation.AI dashboard (Settings → API Keys). Pass as Authorization: Bearer dai_...
path
mediaIdstring
Required

The file's id, from GET /media or an upload result

Format: uuid
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. API key generated from the Documentation.AI dashboard (Settings → API Keys). Pass as Authorization: Bearer dai_...

Path Parameters

mediaIdstring
Required

The file's id, from GET /media or an upload result

Responses

mediaobject

A file in the media library.