Media

Get a video

Check on a video. Poll every 10 seconds or so until status is ready (or failed). If the upload finished but complete wasn't called, this finishes it.

get/media/{id}

Request

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

Path parameters

idstring required

Starts with media_.

Response

The video.

idstring required

The video's id. Starts with media_.

kind'video' | 'image' required

video or image. New kinds may be added.

statusstring required

uploading until the file arrives, processing while we prepare it, then ready or failed. expired means its files were removed after a period of inactivity; upload it again to use it. New values may be added.

filenamestring nullable required
content_typestring nullable required
size_bytesinteger nullable required
duration_secnumber nullable required
widthinteger nullable required
heightinteger nullable required
created_atstring date-time required

When the video was added.

updated_atstring date-time required

When the video last changed.

Example response

{
  "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.