PIpinterest
media

Get media upload details

Changed on

Get details for a registered media upload, including its current status.

Learn more about video Pin creation.

get/media/{media_id}

Request

Path parameters

media_idstring required

Unique identifier for this media upload. Used to track status and for attaching during Pin creation.

Response

The request has succeeded.

media_idstring required

Unique identifier for this media upload. Used to track status and for attaching during Pin creation.

media_type'video' required
status'registered' | 'processing' | 'succeeded' | 'failed'

Example response

{
  "media_id": "12345"
}

Changes

  • v514c297539b64Revision changes
    • breaking

      the response's property type changed from string to no type for status

    • breaking

      the response's property type changed from string to no type for status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      the response optional property became not read-only for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

  • v5723c51158044Revision changes
    • info

      endpoint added