Upload Media

The Upload Media endpoint allows you to temporarily upload files to our storage and use them within your creative automation workflow.

After sending the files to the endpoint you will receive Placid URLs that you can fill into your picture layers.

Endpoint

Method URI
POST https://api.placid.app/api/rest/media

Request

POST /api/rest/media HTTP/1.1
Host: api.placid.app
Authorization: Bearer YOUR_API_TOKEN
Content-Type: multipart/form-data

Content-Disposition: form-data; name="file"; filename="example.jpg"
Content-Type: image/jpeg

[Binary data for the file]

Content-Disposition: form-data; name="file2"; filename="example.jpg"
Content-Type: image/png

[Binary data for the file]

{info} Note: The files must be sent as Content-Type: multipart/form-data

Field Values
file Multiple files can be uploaded by using different custom names. Up to 5 files can be uploaded at once.

Response

File URLs will be returned in a key/value fashion with the names you provided

{
    "media": [
        {
            "file_key": "file",
            "file_id": "https:\/\/storage.placid.app\/2020-01-01\/file.jpg"
        },
        {
            "file_key": "file2",
            "file_id": "https:\/\/storage.placid.app\/2020-01-01\/file.png"
        }
    ]
}