Uploading Media to Brandfolder

Use Case: Uploading from public cloud system

Brandfolder can load media from any direct public url. This often works well when you are initially migrating content into your Brandfolder. In the case of an initial migration, clients will generally create a “migration” section inside their Brandfolder to contain all migrated material and then will organize according to the internal business rules they have.

Prior to the request, ensure that the public url you provide will remain alive for at least a couple of hours (especially for large files).

POST: https://brandfolder.com/api/v4/brandfolders/<brandfolder_key>/assets

Payload:

{
"data": {
    "attributes": [
    { 
        "name": "Example Name", 
        "description": "optional", 
        "attachments": [
             {
              "url": "public url",
              "filename": "optional"
             }
          ]
        } 
    ]
  }
}

Use Case: Uploading from private system

In the case that you want to upload a file from local storage and do not have access to a public URL, you can use our Upload Requests to successfully upload your content. This is a three step process.

1. You need to request an upload url that Brandfolder can use for the file. GET https://brandfolder.com/api/v4/upload_requests

   From the data sent back grab data[“upload_ur’] and data[“object_url”] ← that is the public url to use in the last step

2. Upload the file.

   CURL upload request:

   curl -x PUT --data-binary @/path/to/content <data[“upload_url”]>`

3. Create the asset in Brandfolder following the normal upload media recipe and utilize data[“object_url”] in place of public url.