Sign in

v3

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-012582298.4 KB
Media

Get media status

Retrieves the processing status of an uploaded media file. Poll this endpoint after uploading to check when the file is ready to use in drafts.

If no file is received before the upload URL expires (1 hour), the media transitions to 'failed' — create a new media upload and try again.

Required permission: READ access to the social set.

get/v2/social-sets/{social_set_id}/media/{media_id}

Path parameters

social_set_idinteger required
media_idstring uuid required

Response

OK

media_idstring uuid required

Unique identifier for the media file

file_namestring required

Original filename

mimestring nullable

MIME type of the media file

status'processing' | 'ready' | 'failed' required

Processing status: 'processing' = file is being processed, 'ready' = file is ready to use in posts, 'failed' = processing failed

error_reasonstring nullable

Error message if status is 'failed'. Null otherwise.

media_urlsobject nullable

Dictionary of media URLs. For resizable images (PNG, JPG, WEBP): includes 'small' (600px), 'medium' (1200px), 'large' (3200px), and 'original'. For non-resizable media (GIF, video, PDF): includes only 'original'.

Example response

{
  "file_name": "photo.jpg",
  "mime": "image/jpeg",
  "status": "ready",
  "error_reason": "Unsupported file format",
  "media_urls": {
    "large": "https://cdn.../resized/...",
    "medium": "https://cdn.../resized/...",
    "original": "https://cdn.../original/...",
    "small": "https://cdn.../resized/..."
  }
}