Update Asset — Webflow API Documentation

Update an Asset

Required scope | assets:write

Path parameters

asset_idstringRequired

Unique identifier for an Asset on a site

Request

This endpoint expects an object.

localeIdstringOptional

Unique identifier for a specific locale. Applicable, when using localization.

displayNamestringOptional

A human readable name for the asset

Response

Request was successful

idstringOptional

Unique identifier for this asset

contentTypestringOptional

File format type

sizeintegerOptional

size in bytes

siteIdstringOptional

Unique identifier for the site that hosts this asset

hostedUrlstringOptional

Link to the asset

originalFileNamestringOptional

Original file name at the time of upload

displayNamestringOptional

Display name of the asset

lastUpdateddatetimeOptional

Date the asset metadata was last updated

createdOndatetimeOptional

Date the asset metadata was created

variantslist of objectsOptional

altTextstringOptional

The visual description of the asset

Errors

1 curl -X PATCH https://api.webflow.com/v2/assets/580e63fc8c9a982ac9b8b745 \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{}'

1 { 2 "id": "55131cd036c09f7d07883dfc", 3 "contentType": "image/png", 4 "size": 1500, 5 "siteId": "62749158efef318abc8d5a0f", 6 "hostedUrl": "example.com/hostedimage.png", 7 "originalFileName": "image.png", 8 "displayName": "example-image-123.png", 9 "lastUpdated": "2016-09-06T21:12:22Z", 10 "createdOn": "2016-09-02T23:26:22Z", 11 "variants": [ 12 { 13 "hostedUrl": "example.com/hostedimage.png", 14 "originalFileName": "image.png", 15 "displayName": "A brown dog", 16 "format": "format", 17 "width": 1500, 18 "height": 900, 19 "quality": 1, 20 "error": "error" 21 } 22 ], 23 "altText": "A red chair" 24 }

1	curl -X PATCH https://api.webflow.com/v2/assets/580e63fc8c9a982ac9b8b745 \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{}'

1	{
2	"id": "55131cd036c09f7d07883dfc",
3	"contentType": "image/png",
4	"size": 1500,
5	"siteId": "62749158efef318abc8d5a0f",
6	"hostedUrl": "example.com/hostedimage.png",
7	"originalFileName": "image.png",
8	"displayName": "example-image-123.png",
9	"lastUpdated": "2016-09-06T21:12:22Z",
10	"createdOn": "2016-09-02T23:26:22Z",
11	"variants": [
12	{
13	"hostedUrl": "example.com/hostedimage.png",
14	"originalFileName": "image.png",
15	"displayName": "A brown dog",
16	"format": "format",
17	"width": 1500,
18	"height": 900,
19	"quality": 1,
20	"error": "error"
21	}
22	],
23	"altText": "A red chair"
24	}