Upload Asset | Webflow Developer Documentation

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

{
  "uploadDetails": {
    "acl": "public-read",
    "bucket": "webflow-bucket-name",
    "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
    "X-Amz-Credential": "<credential-key>/<date>/<region-zone>/s3/aws4_request",
    "X-Amz-Date": "<date-in-iso-like-string>",
    "key": "<siteId>/<fileId>_<filename-with-extension>",
    "Policy": "<a-very-long-alphanumeric-token-with-equal-sign-at-the-end>",
    "X-Amz-Signature": "<one-line-ling-alphanumeric-signature>",
    "success_action_status": "201",
    "content-type": "image/png",
    "Cache-Control": "max-age=31536000, must-revalidate"
  },
  "contentType": "image/png",
  "id": "64358b9544249dc43d37d2b7",
  "parentFolder": "6436b1ce5281cace05b65aea",
  "uploadUrl": "https://s3.amazonaws.com/webflow-dev-assets/643021114e290e0d3a0602b2/64358b9544249dc43d37d2b7_Screenshot%202023-04-11%20at%209.50.42%20AM.png",
  "assetUrl": "https://s3.amazonaws.com/webflow-prod-assets/6258612d1ee792848f805dcf/660d907ab9e91e3e9f56385e_paranoidAndroid-2024.png",
  "hostedUrl": "https://dev-assets.website-files.com/643021114e290e0d3a0602b2/64358b9544249dc43d37d2b7_Screenshot%202023-04-11%20at%209.50.42%20AM.png",
  "originalFileName": "file.png",
  "createdOn": "2023-04-11T16:32:21.804Z",
  "lastUpdated": "2023-04-12T20:31:03.197Z"
}

The first step in uploading an asset to a site.

This endpoint generates a response with the following information: uploadUrl and uploadDetails.

Use these properties in the header of a POST request to Amazson s3 to complete the upload.

To learn more about how to upload assets to Webflow, see our assets guide.

Required scope | assets:write

The first step in uploading an asset to a site. This endpoint generates a response with the following information: `uploadUrl` and `uploadDetails`. Use these properties in the header of a [POST request to Amazson s3](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html) to complete the upload. To learn more about how to upload assets to Webflow, see our [assets guide](/data/docs/working-with-assets). Required scope | `assets:write`

Authentication

AuthorizationBearer

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

Path parameters

site_idstringRequiredformat: "objectid"

Unique identifier for a Site

Request

Information about the asset to create

fileNamestringRequired

File name including file extension. File names must be less than 100 characters.

fileHashstringRequired

MD5 hash of the file

parentFolderstringOptional

ID of the Asset folder (optional)

Response

Request was successful

uploadDetailsobject

Metadata for uploading the asset binary

contentTypestring

idstringformat: "objectid"

parentFolderstringformat: "objectid"

Parent folder for the asset

uploadUrlstringformat: "uri"

assetUrlstringformat: "uri"

S3 link to the asset

hostedUrlstringformat: "uri"

Represents the link to the asset

originalFileNamestring

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

createdOnstringformat: "date-time"

Date the asset metadata was created

lastUpdatedstringformat: "date-time"

Date the asset metadata was last updated

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error