> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refmatter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Media access

> Short-lived download URLs for the primary video and the poster frame.

```bash theme={null}
curl "https://api.refmatter.com/v1/media/$MEDIA_ID/download-url" \
  -H "Authorization: Bearer $REFMATTER_API_KEY"
```

```json theme={null}
{
  "mediaId": "01a0a04b-…",
  "downloadUrl": "https://…r2.cloudflarestorage.com/…?X-Amz-Signature=…",
  "expiresAt": "2026-09-14T14:27:00.000Z",
  "contentType": "video/mp4",
  "filename": "jNQXAC9IVRw.mp4"
}
```

Use `primaryMediaId` for the verified video and `posterMediaId` for the poster frame. The URL is valid for five minutes; download promptly and stream directly from it. Requires the `media:read` scope.

<Warning>
  A guessed id, media from another workspace, a deleted reference, or expired media all
  return `404 not_found`. The response never reveals whether the object exists.
</Warning>

For long-term availability, extend the [media hold](/concepts/media-retention) instead of copying the bytes.