Skip to main content

​
Find Recent Images

Get the most recently updated images: 
{
  "filter": {
    "type": { "like": "image/%" },
    "status": { "eq": "active" }
  },
  "sort": [{ "field": "updatedAt", "order": "desc" }],
  "limit": 50
}

​
Find Videos

Find video files: 
{
  "filter": {
    "type": { "like": "video/%" },
    "status": { "eq": "active" }
  },
  "sort": [{ "field": "updatedAt", "order": "desc" }]
}

​
Find Assets by Multiple Tags

Find assets that have both “hero” and “homepage” tags: 
{
  "filter": {
    "tags": { "all": ["hero", "homepage"] },
    "status": { "eq": "active" }
  }
}

​
Find Assets by Any Tag

Find assets that have either “hero” or “banner” tags: 
{
  "filter": {
    "tags": { "any": ["hero", "banner"] },
    "status": { "eq": "active" }
  }
}

​
Find Assets in Date Range

Find assets updated in Q1 2024: 
{
  "filter": {
    "updatedAt": {
      "gte": "2024-01-01T00:00:00Z",
      "lte": "2024-03-31T23:59:59Z"
    }
  },
  "sort": [{ "field": "updatedAt", "order": "asc" }]
}

​
Find Assets by Name Pattern

Find all assets with names starting with “banner-”: 
{
  "filter": {
    "name": { "like": "banner-%" }
  },
  "sort": [{ "field": "updatedAt", "order": "desc" }]
}

​
Find Icons

Find SVG icons: 
{
  "filter": {
    "type": { "eq": "image/svg+xml" },
    "tags": { "any": ["icon"] },
    "status": { "eq": "active" }
  }
}

​
Find Assets Without Specific Tags

Find active assets that need categorization: 
{
  "filter": {
    "status": { "eq": "active" }
  },
  "sort": [{ "field": "updatedAt", "order": "asc" }]
}

​
Pagination Example

Fetch results with 25 items per page: 
{
  "filter": {
    "type": { "like": "image/%" }
  },
  "sort": [{ "field": "updatedAt", "order": "desc" }],
  "limit": 25
}
For subsequent pages, include the lastKey from the previous response’s pagination object.

​
Combined Query Parameters and Body

Using URL parameters for common filters and body for complex conditions: 
POST /app/v1/organizations/org123/projects/proj456/assets/search?status=active&sort=updatedAt:desc

{
  "filter": {
    "type": { "in": ["image/jpeg", "image/png", "image/webp"] },
    "tags": { "any": ["product", "thumbnail"] }
  },
  "limit": 100
}