Get media

GET /media/:id

Returns detailed information about a specific media file, including type, dimensions, file size, and processing status.

Round-trip safe

The media_id returned here is the same value you pass into POST /v1/posts as part of the media_ids array. The response also includes media_ids as a convenience single-element array you can copy straight into a post payload.

No url or storage_url field

For security, this endpoint does not return direct storage URLs. Media is delivered to the social platforms through signed, time-limited worker requests — never by exposing raw storage URLs back to API clients. If you need a preview for your own UI, use the PostEverywhere web app or generate your own thumbnails on upload.

Path Parameters

Parameter	Type	Required	Description
`media_id`	string (UUID)	Yes	UUID of the media file. Accepts `id` as a deprecated alias in the URL path.

Response Example

200 — Media details

{
  "data": {
    "media_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "media_ids": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
    "status": "ready",
    "type": "image",
    "filename": "product-photo.jpg",
    "content_type": "image/jpeg",
    "size": 2048576,
    "width": 1920,
    "height": 1080,
    "duration": null,
    "created_at": "2026-04-10T12:00:00.000Z"
  },
  "error": null,
  "meta": {
    "request_id": "a1b2c3d4",
    "timestamp": "2026-04-10T12:00:00.000Z"
  }
}

Response fields

Field	Type	Description
`media_id`	string (UUID)	Canonical media identifier
`media_ids`	string[] (UUID)	Convenience single-element array
`status`	string	`ready`, `processing`, or `failed`
`type`	string	`image`, `video`, or `document`
`filename`	string	Original filename supplied at upload
`content_type`	string	MIME type
`size`	integer	File size in bytes
`width`	integer or null	Pixel width (images/videos)
`height`	integer or null	Pixel height (images/videos)
`duration`	number or null	Duration in seconds (videos only)
`created_at`	string (ISO 8601)	UTC timestamp when the media record was created

Request

Responses

Media details

Get media

/media/:id

Path Parameters​

Response Example​

200 — Media details​

Response fields​

Request​

Responses​