The Assets API provides a flexible unified search approach that supports both simple query parameters and advanced filtering through request bodies.
Quick Reference
| Method | Use Case |
|---|
| GET with query params | Simple filtering by single values |
| POST with body | Complex filtering with operators |
| Combined | Mix both for flexibility |
Query Parameters (GET)
When using the GET method, apply filters through URL query parameters:
GET /app/v1/organizations/:organizationId/projects/:projectId/assets?type=image/jpeg&tags=hero&sort=updatedAt:desc
| Parameter | Type | Description |
|---|
limit | number | Items per page (default: 10) |
lastKey | string | Pagination cursor from previous response |
type | string | Filter by MIME type |
tags | string | Filter by tag IDs (comma-separated) |
status | string | Filter by status (active or deleted) |
search | string | Search term for name/description |
sort | string | Sort field and direction (e.g., name:asc) |
from | string | Updated date range start (ISO format) |
to | string | Updated date range end (ISO format) |
Sort Fields
| Field | Description | Example |
|---|
updatedAt | Sort by last modification (default) | sort=updatedAt:desc |
When no sort is specified, resources are sorted by updatedAt:desc by default.
