List Assets | Webflow Developer Documentation

curl -G https://api.webflow.com/v2/sites/580e63e98c9a982ac9b8b741/assets \
     -H "Authorization: Bearer <token>" \
     -d localeId=65427cf400e02b306eaa04a0 \
     -d offset=0 \
     -d limit=100

{
  "assets": [
    {
      "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",
      "folderId": "6390c49774a71f99f21a08eb"
    },
    {
      "id": "63e5889e7fe4eafa7384cea5",
      "contentType": "image/png",
      "size": 2212772,
      "siteId": "63938b302ea6b0aa6f3d8745",
      "hostedUrl": "https://s3.amazonaws.com/webflow-prod-assets/63938b302ea6b0aa6f3d8745/63e5889e7fe4eafa7384cea4_Vectors-Wrapper.svg",
      "originalFileName": "Gum-Wrapper.svg",
      "displayName": "63e5889e7fe4eafa7384cea5_Gum-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 gum wrapper",
      "folderId": null
    }
  ],
  "pagination": {
    "limit": 2,
    "offset": 0,
    "total": 2
  }
}

List of assets uploaded to a site

Required scope | assets:read

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

Query parameters

localeIdstringOptional

Unique identifier for a specific Locale.

Learn more about localization.

offsetintegerOptional

Offset used for pagination if the results have more than limit records

limitintegerOptional

Maximum number of records to be returned (max limit: 100)

folderIdstringOptionalformat: "objectid"

Filter assets to those in the specified folder and all descendant folders. Must be a 24-character hex ObjectId.

Response

Request was successful

assetslist of objects

paginationobject

Pagination object

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error