PIpinterest
media

Register media upload

Changed on

Register your intent to upload media.

The response includes all of the information needed to upload the media to Pinterest.

To upload the media, make an HTTP POST request (using curl, for example) to upload_url using the Content-Type header value. Send the media file's contents as the request's file parameter and also include all of the parameters from upload_parameters.

Learn more about video Pin creation.

post/media

Request

Request body

media_type'video' required

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
upload_urlstring

The URL where you will POST your media file.

Example response

{
  "media_id": "12345",
  "upload_parameters": {
    "Content-Type": "multipart/form-data",
    "key": "uploads/11/aa/22/3:video:203014033110991560:5212123920968240771",
    "policy": "eyJleHBpcmF0aW9uIjoiMj..==",
    "x-amz-algorithm": "AWS4-HMAC-SHA256",
    "x-amz-credential": "ASIA6QZJ64OPIKV7FRVX/20220127/us-east-1/s3/aws4_request",
    "x-amz-date": "20220127T185143Z",
    "x-amz-security-token": "IQoJb3JpZ2luX2VjEJr...==",
    "x-amz-signature": "fcd6309a6aaee213348666a72abed8b44552a43acb6b340e8e1b288d21a5fe92"
  },
  "upload_url": "https://pinterest-media-upload.s3-accelerate.amazonaws.com/"
}

Changes

  • v514c297539b64Revision changes
    • breaking

      the request property type changed from string to no type

    • info

      the request required property became not write-only

    • info

      removed subschema #1 from the response body allOf list for the response 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

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the success response with the status

  • v5f9321315766fRevision changes
    • breaking

      the response's body type changed from no type to object for status