Update Asset | Webflow Developer Documentation

curl -X PATCH "https://api.webflow.com/beta/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,
      "height": null,
      "quality": 100,
      "error": null
    }
  ],
  "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

folderIdstring or nullformat: "objectid"

The ID of the folder the asset belongs to, or null if the asset is at the site root. This field is present only in list responses (GET /sites/{site_id}/assets).

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error