v1

latestOpenAPI 3.0.32026-08-067332206.6 KB

assets

Fetch an asset

Fetches the matching asset.

get/assets/{asset_id}

Query parameters

fieldsstring

Set it to a comma-separated list (no spaces) of any of the following attributes of the asset to return as part of the asset's attributes in the response.

Allowed values:

created_at
updated_at
cdn_url
availability
availability_start
availability_end

WARNING: This parameter can slow response times.

includestring

Set it to a comma-separated list (no spaces) of any of the following record names to return those records related to the asset you're fetching. Related records are returned in an included array in the response.

Allowed values:

attachments
brandfolder
collections
custom_fields
section
tags

WARNING: This parameter can slow response times.

Headers

Accept'application/json' required

Response

The matching asset.

Example response

{
  "data": {
    "id": "oqgkkd-fr5iv4-443db",
    "attributes": {
      "name": "Brandfolder Logo",
      "description": "Brandfolder's logo in print ready format",
      "thumbnail_url": "https://example.com/example.jpg?Expires=1624742369",
      "approved": true
    }
  }
}