Media

List videos

Your workspace's videos, newest first.

get/media

Request

  • Base URL: https://api.deploy.social/v1
  • URL: https://api.deploy.social/v1/media
  • Auth: HTTP bearer

Query parameters

limitinteger

How many to return, 1 to 100. Defaults to 25.

Example:25
cursorstring

The next_cursor from the previous page.

statusstring

Only these statuses, comma-separated.

Example:ready
kind'video' | 'image'

video (the default) or image.

Example:video

Response

A page of videos.

next_cursorstring nullable required

Pass as cursor for the next page. null on the last page.

Example response

{
  "data": [
    {
      "id": "media_cmf3k0m2b0000ab12cd34ef56",
      "kind": "video",
      "status": "ready",
      "filename": "studio-update.mp4",
      "content_type": "video/mp4",
      "size_bytes": 48213377,
      "duration_sec": 42.5,
      "width": 1080,
      "height": 1920,
      "progress": {
        "phase": "transcoding",
        "percent": 62
      },
      "created_at": "2026-10-01T15:00:00.000Z",
      "updated_at": "2026-10-01T15:00:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.