---
title: "Update an asset"
method: PUT
path: "/assets/{asset_id}"
tags: ["assets"]
---

# Update an asset

`PUT /assets/{asset_id}`

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.

## Request body

- object
  - `data` object, required
    - `attributes` AssetAttributesRequest, required
      - `name` string, required — The name of the asset.
      - `description` string — The description of the asset.
      - `thumbnail_url` string — The online location of the asset.
      - `approved` boolean — If `true`, this asset is approved; otherwise, it's not.
      - `availability_start` string, date-time — This represents the publish/availability date in Brandfolder, the label `draft` will show.
      - `availability_end` string, date-time — This represents the expiration date in brandfolder, the label `expired` will show.
      - `attachments` object[] — An array of Attachment objects to add to the Asset (these do not overwrite exisiting Attachments).
        - `url` string, required — A fully-formed URL of the file to upload (required for each new Attachment).
        - `filename` string — A complete file name, with extension.

## Response `200`

The updated asset.

- object
  - `data` Asset, required
    - `id` string, required — Unique identifier for the resource instance.
    - `type` 'generic_files', required — The type of the resource.
    - `attributes` AssetAttributes, required
      - `name` string — The name of the asset.
      - `description` string — The description of the asset.
      - `thumbnail_url` string — The online location of the asset.
      - `approved` boolean — If `true`, this asset is approved; otherwise, it's not.

## Other responses

- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/brandfolder-openapi-reference/revisions/fd95b0a2d2f8/schema)