Comparison Operators
| Operator | Description | Example |
|---|
eq | Equals | {"status": {"eq": "active"}} |
neq | Not equals | {"status": {"neq": "deleted"}} |
gt | Greater than | {"updatedAt": {"gt": "2024-01-01"}} |
gte | Greater than or equal | {"updatedAt": {"gte": "2024-01-01"}} |
lt | Less than | {"updatedAt": {"lt": "2024-12-31"}} |
lte | Less than or equal | {"updatedAt": {"lte": "2024-12-31"}} |
Example: Date Range
{
"filter": {
"updatedAt": {
"gte": "2024-01-01T00:00:00Z",
"lte": "2024-12-31T23:59:59Z"
}
}
}
Array Operators
| Operator | Description | Example |
|---|
in | Value in array | {"type": {"in": ["image/jpeg", "image/png"]}} |
all | Contains all values | {"tags": {"all": ["hero", "product"]}} |
any | Contains any value | {"tags": {"any": ["hero", "banner"]}} |
Example: Multiple Types
{
"filter": {
"type": {
"in": ["image/jpeg", "image/png", "image/webp"]
}
}
}
Example: Tag Matching
{
"filter": {
"tags": {
"all": ["hero", "homepage"]
}
}
}
Pattern Operators
| Operator | Description | Example |
|---|
like | Pattern matching (% wildcard) | {"name": {"like": "hero%"}} |
Example: Name Pattern
{
"filter": {
"name": {
"like": "banner-%"
}
}
}
Combining Operators
Multiple operators can be combined within a single filter:
{
"filter": {
"type": {
"in": ["image/jpeg", "image/png"]
},
"tags": {
"any": ["hero", "product"]
},
"status": {
"eq": "active"
},
"updatedAt": {
"gte": "2024-01-01T00:00:00Z"
}
}
}
All filter conditions are combined with AND logic. An asset must match all conditions to be included in results.
