v1

latestOpenAPI 3.0.32026-08-067332206.6 KB

assets

collections

Create assets in a collection

Creates assets in the matching collection.

Any files you wish to use as an Attachment in Brandfolder must be hosted at a publicly available URL (until they have been successfully imported). If you need to upload file contents directly to a server, you can use do a binary file upload to our temporary storage bucket and then use that URL when creating Assets/Attachments.

post/collections/{collection_id}/assets

Request body

section_keystring required

ID of the Section in which you want the newly created Asset(s) to live.

Example request

{
  "data": {
    "attributes": [
      {
        "name": "Brandfolder Logo",
        "description": "Brandfolder's logo in print ready format",
        "thumbnail_url": "https://example.com/example.jpg?Expires=1624742369",
        "approved": true,
        "availability_start": "2024-02-23T18:22:49.771Z",
        "availability_end": "2025-02-23T18:22:49.771Z",
        "attachments": [
          {
            "url": "https://example.com/new-attachment.jpg",
            "filename": "new-attachment.jpg"
          }
        ]
      }
    ]
  },
  "section_key": "oqgol8-dslwxs-58b2z3"
}

Response

The new assets.

Example response

{
  "data": [
    {
      "id": "oqgkkd-fr5iv4-443db",
      "attributes": {
        "name": "Brandfolder Logo",
        "description": "Brandfolder's logo in print ready format",
        "thumbnail_url": "https://example.com/example.jpg?Expires=1624742369",
        "approved": true
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1
  }
}