`video`

A video worth the user's next ten minutes — an upload, a recording, a clip.

A video card with duration and thumbnail.

A rendered video pane (video-v1) — video-v1

Fields in `data`

The envelope around data (publisher, label, expiresAt…) is the same on every type: see the envelope.

Field	Type		Notes
`variant`	`"v1"`	optional	Design variant to render (defaults to v1).
`title`	`string`	required	1–200 chars
`sub`	`string`	optional	up to 240 chars
`duration`	`string`	optional	up to 16 chars
`aspect`	`string`	optional	up to 16 chars
`url`	`string`	optional	format: uri
`thumbnailUrl`	`string`	optional	format: uri

Craft

duration is pre-formatted and honest: "4:21", "1:02:30". It's the main thing people decide on.
Send thumbnailUrl — a video card without a still is a grey box.
aspect should match the source ("16 / 9" landscape, "9 / 16" vertical) so the card doesn't letterbox.
title is the video's own title; sub is the channel, series, or context.
url should open the video directly (deep link or watch page), not a channel index.

Avoid

Don't publish a video card without url — there's nothing to do with it.
Don't estimate duration — omit it if you don't know.
Don't use video for a livestream that's already ended.

Examples

Complete payloads for POST /api/v1/feed/items or the MCP publish_pane tool.

A new upload from a subscribed channel

{
  "type": "video",
  "publisher": "YouTube",
  "publisherInit": "YT",
  "publisherColor": "#FF0000",
  "label": "New from Veritasium",
  "data": {
    "title": "The engineering problem nobody solved for 40 years",
    "sub": "Veritasium · 1.2M views",
    "duration": "18:42",
    "aspect": "16 / 9",
    "url": "https://www.youtube.com/watch?v=example",
    "thumbnailUrl": "https://i.ytimg.com/vi/example/maxresdefault.jpg"
  }
}

A meeting recording the user missed

{
  "type": "video",
  "publisher": "Zoom",
  "publisherInit": "Z",
  "publisherColor": "#2D8CFF",
  "label": "You were double-booked",
  "data": {
    "title": "Q3 roadmap review",
    "sub": "Product weekly · 8 attendees",
    "duration": "47:15",
    "aspect": "16 / 9",
    "url": "https://zoom.us/rec/share/example",
    "thumbnailUrl": "https://example.com/thumbs/roadmap-review.jpg"
  }
}

video