Create Asset Metadata — Webflow API Documentation

Create a new asset entry.

This endpoint generates a response with the following information: uploadUrl and uploadDetails. You can use these two properties to upload the file to Amazon s3 by making a POST request to the uploadUrl with the uploadDetails object as your header information in the request.

Required scope | assets:write

Path parameters

site_idstringRequired

Unique identifier for a Site

Request

This endpoint expects an object.

fileNamestringRequired

file name including file extension

fileHashstringRequired

MD5 hash of the file

parentFolderstringOptional

ID of the Asset folder (optional)

Response

Request was successful

uploadDetailsobjectOptional

Metadata for uploading the asset binary

contentTypestringOptional

idstringOptional

parentFolderstringOptional

Parent folder for the asset

uploadUrlstringOptional

assetUrlstringOptional

S3 link to the asset

hostedUrlstringOptional

Represents the link to the asset

originalFileNamestringOptional

Original file name when uploaded. If not specified at time of upload, it may be extracted from the raw file name

createdOndatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

Date the asset metadata was created

lastUpdateddatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

Date the asset metadata was last updated

Errors

1 curl -X POST https://api.webflow.com/v2/sites/580e63e98c9a982ac9b8b741/assets \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "fileName": "file.png", 6 "fileHash": "3c7d87c9575702bc3b1e991f4d3c638e" 7 }'

1 { 2 "uploadDetails": { 3 "acl": "public-read", 4 "bucket": "webflow-bucket-name", 5 "X-Amz-Algorithm": "AWS4-HMAC-SHA256", 6 "X-Amz-Credential": "<credential-key>/<date>/<region-zone>/s3/aws4_request", 7 "X-Amz-Date": "<date-in-iso-like-string>", 8 "key": "<siteId>/<fileId>_<filename-with-extension>", 9 "Policy": "<a-very-long-alphanumeric-token-with-equal-sign-at-the-end>", 10 "X-Amz-Signature": "<one-line-ling-alphanumeric-signature>", 11 "success_action_status": "201", 12 "content-type": "image/png", 13 "Cache-Control": "max-age=31536000, must-revalidate" 14 }, 15 "contentType": "image/png", 16 "id": "64358b9544249dc43d37d2b7", 17 "parentFolder": "6436b1ce5281cace05b65aea", 18 "uploadUrl": "https://s3.amazonaws.com/webflow-dev-assets/643021114e290e0d3a0602b2/64358b9544249dc43d37d2b7_Screenshot%202023-04-11%20at%209.50.42%20AM.png", 19 "assetUrl": "https://s3.amazonaws.com/webflow-prod-assets/6258612d1ee792848f805dcf/660d907ab9e91e3e9f56385e_paranoidAndroid-2024.png", 20 "hostedUrl": "https://d1otoma47x30pg.cloudfront.net/643021114e290e0d3a0602b2/64358b9544249dc43d37d2b7_Screenshot%202023-04-11%20at%209.50.42%20AM.png", 21 "originalFileName": "file.png", 22 "createdOn": "2023-04-11T16:32:21Z", 23 "lastUpdated": "2023-04-12T20:31:03Z" 24 }

1	curl -X POST https://api.webflow.com/v2/sites/580e63e98c9a982ac9b8b741/assets \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"fileName": "file.png",
6	"fileHash": "3c7d87c9575702bc3b1e991f4d3c638e"
7	}'

1	{
2	"uploadDetails": {
3	"acl": "public-read",
4	"bucket": "webflow-bucket-name",
5	"X-Amz-Algorithm": "AWS4-HMAC-SHA256",
6	"X-Amz-Credential": "<credential-key>/<date>/<region-zone>/s3/aws4_request",
7	"X-Amz-Date": "<date-in-iso-like-string>",
8	"key": "<siteId>/<fileId>_<filename-with-extension>",
9	"Policy": "<a-very-long-alphanumeric-token-with-equal-sign-at-the-end>",
10	"X-Amz-Signature": "<one-line-ling-alphanumeric-signature>",
11	"success_action_status": "201",
12	"content-type": "image/png",
13	"Cache-Control": "max-age=31536000, must-revalidate"
14	},
15	"contentType": "image/png",
16	"id": "64358b9544249dc43d37d2b7",
17	"parentFolder": "6436b1ce5281cace05b65aea",
18	"uploadUrl": "https://s3.amazonaws.com/webflow-dev-assets/643021114e290e0d3a0602b2/64358b9544249dc43d37d2b7_Screenshot%202023-04-11%20at%209.50.42%20AM.png",
19	"assetUrl": "https://s3.amazonaws.com/webflow-prod-assets/6258612d1ee792848f805dcf/660d907ab9e91e3e9f56385e_paranoidAndroid-2024.png",
20	"hostedUrl": "https://d1otoma47x30pg.cloudfront.net/643021114e290e0d3a0602b2/64358b9544249dc43d37d2b7_Screenshot%202023-04-11%20at%209.50.42%20AM.png",
21	"originalFileName": "file.png",
22	"createdOn": "2023-04-11T16:32:21Z",
23	"lastUpdated": "2023-04-12T20:31:03Z"
24	}