---
title: "Stream a published motion-story video (Range-enabled)"
method: GET
path: "/dashboards/url/{url}/video.mp4"
tags: ["Dashboard v3"]
---

# Stream a published motion-story video (Range-enabled)

`GET /dashboards/url/{url}/video.mp4`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/dashboards/url/{url}/video.mp4`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Serve the stored MP4 for the token-authenticated PUBLISHED view, keyed by the published sequence. Supports a single HTTP `Range` (206 partial content) so the `<video>` preview can seek; a multi-range request falls back to the full body (browser video seeking only issues single ranges). `ETag: "{sequence}"` + public cache headers; the og:image-style `?v={sequence}` cache-buster invalidates on republish. 404 when no clip was exported (a normal state — export is on demand) and for a board with row-level security on, whose whole-dataset clip cannot be scoped to the viewer streaming it. `?aspect=square|portrait` streams that clip; omitted, the landscape one (the urls /video-state and the export job hand back already carry it). Auth mirrors the other public /url/ surfaces.

## Path parameters

- `url` string, required

## Response `200`

Request fulfilled, document follows

## Other responses

- `400`: Bad request syntax or unsupported method
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/fe078afe239b?raw)