MediaDelete a file

Delete a file

Deletes a file from the media library and frees its storage. Pages that use the file show it as missing. Requires admin role.

curl -X DELETE "https://api.documentationai.app/api/v1/media/123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "deleted": {
    "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" />"
  }
}
DELETE
/media/{mediaId}
DELETE
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

deletedobject

A file in the media library.