Update Asset | Webflow Developer Documentation

curl -X PATCH "https://api.webflow.com/v2/assets/580e63fc8c9a982ac9b8b745?localeId=65427cf400e02b306eaa04a0" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "id": "63e5889e7fe4eafa7384cea4",
  "contentType": "image/png",
  "size": 2212772,
  "siteId": "63938b302ea6b0aa6f3d8745",
  "hostedUrl": "https://s3.amazonaws.com/webflow-prod-assets/63938b302ea6b0aa6f3d8745/63e5889e7fe4eafa7384cea4_Vectors-Wrapper.svg",
  "originalFileName": "Candy-Wrapper.svg",
  "displayName": "63e5889e7fe4eafa7384cea4_Candy-Wrapper.png",
  "lastUpdated": "2023-03-01T23:42:57.862Z",
  "createdOn": "2023-02-09T23:58:22.294Z",
  "variants": [
    {
      "hostedUrl": "https://s3.amazonaws.com/webflow-prod-assets/6258612d1ee792848f805dcf/660d83ce30f3a599ddb0bdb3_Screenshot%202024-03-20%20at%209.03.24%E2%80%AFPM-p-500.png",
      "originalFileName": "Screenshot%202024-03-20%20at%209.03.24%E2%80%AFPM-p-500.png",
      "displayName": "660d83ce30f3a599ddb0bdb3_Screenshot%202024-03-20%20at%209.03.24%E2%80%AFPM-p-500.png",
      "format": "png",
      "width": 500,
      "quality": 100
    }
  ],
  "altText": "A single candy wrapper"
}

Update details of an Asset.

Required scope | assets:write

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

asset_idstringRequiredformat: "objectid"

Unique identifier for an Asset on a site

Query parameters

localeIdstringOptional

Unique identifier for a specific Locale.

Learn more about localization.

Request

Information about the asset to update

displayNamestringOptional

A human readable name for the asset. This value is not localizable.

altTextstringOptional

Alternate text describing the image

Response

Request was successful

idstringRead-onlyformat: "objectid"

Unique identifier for this asset

contentTypestringRead-onlyformat: "mime-type"

File format type

sizeintegerRead-only

size in bytes

siteIdstringRead-onlyformat: "objectid"

Unique identifier for the site that hosts this asset

hostedUrlstringRead-onlyformat: "uri"

Link to the asset

originalFileNamestringRead-only

Original file name at the time of upload

displayNamestring

Display name of the asset

lastUpdatedstringRead-onlyformat: "date-time"

Date the asset metadata was last updated

createdOnstringRead-onlyformat: "date-time"

Date the asset metadata was created

variantslist of objects

A list of asset variants created by Webflow to serve your site responsively.

altTextstring or null

The visual description of the asset

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error