v1

latestOpenAPI 3.0.32026-08-067332206.6 KB

assets

Update an asset

Updates the matching asset.

Note: All attributes are optional when updating. Only include the ones you want to change.

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.

put/assets/{asset_id}

Request body

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"
        }
      ]
    }
  }
}

Response

The updated asset.

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
    }
  }
}