Searching Overview

Method	Use Case
GET with query params	Simple filtering by single values
POST with body	Complex filtering with operators
Combined	Mix both for flexibility

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)

Field	Description	Example
`updatedAt`	Sort by last modification (default)	`sort=updatedAt:desc`

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.

Quick Reference