---
title: media_link
description: Get a short-lived download link for a file a run produced (audio, image, video, PDF, or a large text or CSV answer).
---

<WorksIn />

Some runs produce a file instead of JSON: speech from a text-to-speech tool, a generated image or
video, a PDF, a screenshot, or a text or CSV answer larger than 256 KB. looot stores the file and
puts a `media` block on the run result. `media_link` turns that block into a download link that
works with plain `curl` or `fetch`, no token, for 15 minutes. Call it again for a fresh link.

## Inputs

| Argument | Type | Required | Default | Limits | Meaning |
| --- | --- | --- | --- | --- | --- |
| `runId` | string | Yes | | | The run that produced the file, from [`run`](/mcp-tools/run) or [`runs_list`](/mcp-tools/runs-list). |
| `mediaId` | string | No | the run's only file | | Which file, when the run produced several. The error lists the ids. |
| `inline` | boolean | No | false | png, jpeg, gif or webp up to 200 KB | Also return the image itself next to the link. Audio, video and PDF are never inline. |

## Example call

```json
{
  "runId": "run_aa487ec9cbed4275acda99558ce55349"
}
```

## Example answer

```json
{
  "runId": "run_aa487ec9cbed4275acda99558ce55349",
  "mediaId": "44775a8177a0e58729bc7fabe6193c4b",
  "contentType": "application/pdf",
  "byteLength": 28798,
  "sha256": "9b1f...",
  "expiresAt": "2026-10-31T00:00:00.000Z",
  "downloadUrl": "https://api.looot.ai/v1/media-downloads/run_aa487ec9cbed4275acda99558ce55349/44775a8177a0e58729bc7fabe6193c4b?exp=...&sig=...",
  "downloadUrlExpiresAt": "2026-10-02T00:15:00.000Z",
  "downloadPath": "/v1/runs/run_aa487ec9cbed4275acda99558ce55349/media/44775a8177a0e58729bc7fabe6193c4b",
  "filename": "steel-pdf.pdf"
}
```

Check the download against `sha256`. `downloadPath` works too, with your agent token in the
`Authorization` header. `expiresAt` is when looot deletes the stored file.

## Errors

| Code | Meaning |
| --- | --- |
| `run_not_found` | No run with that id in this workspace. |
| `media_not_found` | That run has no stored file with that `mediaId`. |
| `media_id_required` | The run has several files; call again with one of the listed `mediaId`s. |
| `media_expired` | The file passed its retention time. Run the tool again. |
| `media_links_disabled` | Signed links are off on this gateway; download `downloadPath` with a token instead. |

`media_link` is free. It never runs a provider and never charges.

<Related />