MediaList media

List media

Returns the files in the media library, newest first. Search by file name or alt text, or filter by kind of file.

curl -X GET "https://api.documentationai.app/api/v1/media?search=example_string&kind=image&page=1&limit=20" \
  -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" />"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "pages": 3
  }
}
GET
/media
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_...
query
kindstring

Return only one kind of file

Options: image, video, audio, document, data, archive, font
query
pageinteger

Page of results to return

Min: 1
query
limitinteger

Files per page, up to 100

Min: 1 • Max: 100
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_...

Query Parameters

kindstring

Return only one kind of file

Allowed values:imagevideoaudiodocumentdataarchivefont
pageinteger

Page of results to return

limitinteger

Files per page, up to 100

Responses

mediaarray
paginationobject