List and search assets

Query DAM assets using tree paths and tags

Searches and retrieves DAM assets using tree path pattern matching, tag-based variant filtering, wildcard name matching, and partial search. Requires a company admin Bearer token with media view permission, or a token granted the dam:browse scope. Results are cursor-paginated over matching asset paths - pass limit (default 50, max 100) and the opaque meta.next_cursor from the previous response as cursor. A missing path, an invalid path pattern, or too many tags returns 400.

POST

api

dam

query

Query DAM assets using tree paths and tags

curl --request POST \
  --url https://api.fluid.app/api/dam/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "path": "1405.image.*",
  "tags_string": "product,hero",
  "search": "copy paper",
  "exclude_categories": "videos,audio",
  "limit": 1
}
'

import requests

url = "https://api.fluid.app/api/dam/query"

payload = {
    "path": "1405.image.*",
    "tags_string": "product,hero",
    "search": "copy paper",
    "exclude_categories": "videos,audio",
    "limit": 1
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    path: '1405.image.*',
    tags_string: 'product,hero',
    search: 'copy paper',
    exclude_categories: 'videos,audio',
    limit: 1
  })
};

fetch('https://api.fluid.app/api/dam/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/dam/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'path' => '1405.image.*',
    'tags_string' => 'product,hero',
    'search' => 'copy paper',
    'exclude_categories' => 'videos,audio',
    'limit' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/dam/query"

	payload := strings.NewReader("{\n  \"path\": \"1405.image.*\",\n  \"tags_string\": \"product,hero\",\n  \"search\": \"copy paper\",\n  \"exclude_categories\": \"videos,audio\",\n  \"limit\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/dam/query")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"path\": \"1405.image.*\",\n  \"tags_string\": \"product,hero\",\n  \"search\": \"copy paper\",\n  \"exclude_categories\": \"videos,audio\",\n  \"limit\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/dam/query")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"path\": \"1405.image.*\",\n  \"tags_string\": \"product,hero\",\n  \"search\": \"copy paper\",\n  \"exclude_categories\": \"videos,audio\",\n  \"limit\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "path": "1405.image.*",
  "tree": {
    "1405": {
      "image": {
        "png": {
          "K7QM4X": {
            "asset_code": "K7QM4X",
            "name": "20lb Copy Paper Hero",
            "category": "images",
            "created_at": "2026-09-14T15:22:08Z",
            "variants": [
              {
                "file_name": "20lb-copy-paper-hero.png",
                "mime_type": "image/png",
                "updated_at": "2026-09-21T09:47:31Z",
                "metadata": {
                  "mime": "image/png",
                  "width": 2400,
                  "height": 1600,
                  "size": 184320
                },
                "tags": [
                  "product",
                  "hero"
                ],
                "default": true,
                "url": "https://cdn.fluid.app/dunder-mifflin/dam/K7QM4X/20lb-copy-paper-hero.png",
                "content": null,
                "data": null
              }
            ]
          }
        }
      }
    }
  },
  "meta": {
    "request_id": "5e2a8d14-7c3f-4b91-9a6e-0f4d2c8b7e13",
    "timestamp": "2026-09-30T14:07:45Z",
    "total_count": 37,
    "next_cursor": "eyJhc3NldF9wYXRoX2lkIjo5MTc0MiwiY3JlYXRlZF9hdCI6IjIwMjYtMDktMTRUMTU6MjI6MDhaIn0=",
    "has_more": true,
    "limit": 1
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

Bearer token authentication

Body

application/json

path

Required tree path pattern for hierarchical filtering

tags_string

Optional comma/semicolon-separated tag string for variant filtering. Comma = OR, Semicolon = AND

name

Optional asset name with wildcard support

Optional partial search across asset names and descriptions (case-insensitive)

exclude_tags

Optional tag names to exclude, as a comma-separated string or an array. Variants carrying these tags are left out of the tree.

exclude_categories

Optional asset categories to exclude (images, videos, audio, text, data, documents, other), as a comma-separated string or an array.

limit

Maximum number of asset paths to return per page. Defaults to 50 and is clamped to the range 1-100.

cursor

string | null

Opaque cursor from a previous response's meta.next_cursor. Omit it to fetch the first page.

Response

object | null

Success

path

The path pattern that was queried

tree

object | null

Nested tree structure of assets organized by path segments. Folder nodes are objects keyed by the next path segment; each leaf is an asset object with asset_code, name, category, created_at, and a variants array (file_name, mime_type, updated_at, metadata, tags, default, url, content, data).

Show child attributes

meta

object | null

Show child attributes

Query DAM assets using tree paths and tags

curl --request POST \
  --url https://api.fluid.app/api/dam/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "path": "1405.image.*",
  "tags_string": "product,hero",
  "search": "copy paper",
  "exclude_categories": "videos,audio",
  "limit": 1
}
'

import requests

url = "https://api.fluid.app/api/dam/query"

payload = {
    "path": "1405.image.*",
    "tags_string": "product,hero",
    "search": "copy paper",
    "exclude_categories": "videos,audio",
    "limit": 1
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    path: '1405.image.*',
    tags_string: 'product,hero',
    search: 'copy paper',
    exclude_categories: 'videos,audio',
    limit: 1
  })
};

fetch('https://api.fluid.app/api/dam/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/dam/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'path' => '1405.image.*',
    'tags_string' => 'product,hero',
    'search' => 'copy paper',
    'exclude_categories' => 'videos,audio',
    'limit' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/dam/query"

	payload := strings.NewReader("{\n  \"path\": \"1405.image.*\",\n  \"tags_string\": \"product,hero\",\n  \"search\": \"copy paper\",\n  \"exclude_categories\": \"videos,audio\",\n  \"limit\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/dam/query")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"path\": \"1405.image.*\",\n  \"tags_string\": \"product,hero\",\n  \"search\": \"copy paper\",\n  \"exclude_categories\": \"videos,audio\",\n  \"limit\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/dam/query")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"path\": \"1405.image.*\",\n  \"tags_string\": \"product,hero\",\n  \"search\": \"copy paper\",\n  \"exclude_categories\": \"videos,audio\",\n  \"limit\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "path": "1405.image.*",
  "tree": {
    "1405": {
      "image": {
        "png": {
          "K7QM4X": {
            "asset_code": "K7QM4X",
            "name": "20lb Copy Paper Hero",
            "category": "images",
            "created_at": "2026-09-14T15:22:08Z",
            "variants": [
              {
                "file_name": "20lb-copy-paper-hero.png",
                "mime_type": "image/png",
                "updated_at": "2026-09-21T09:47:31Z",
                "metadata": {
                  "mime": "image/png",
                  "width": 2400,
                  "height": 1600,
                  "size": 184320
                },
                "tags": [
                  "product",
                  "hero"
                ],
                "default": true,
                "url": "https://cdn.fluid.app/dunder-mifflin/dam/K7QM4X/20lb-copy-paper-hero.png",
                "content": null,
                "data": null
              }
            ]
          }
        }
      }
    }
  },
  "meta": {
    "request_id": "5e2a8d14-7c3f-4b91-9a6e-0f4d2c8b7e13",
    "timestamp": "2026-09-30T14:07:45Z",
    "total_count": 37,
    "next_cursor": "eyJhc3NldF9wYXRoX2lkIjo5MTc0MiwiY3JlYXRlZF9hdCI6IjIwMjYtMDktMTRUMTU6MjI6MDhaIn0=",
    "has_more": true,
    "limit": 1
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Overview

Storefront

Commerce

Checkout

Members

Messaging

People

Payments

DAM

Website

Portal

Content and tools

Analytics

Sales channels

Settings

FairShare SDK

Droplets

Developers

Portal & Widgets

Query DAM assets using tree paths and tags

Authorizations

Body

Response