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.


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


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.


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"