Documentation Index
Fetch the complete documentation index at: https://docs.metabind.ai/llms.txt
Use this file to discover all available pages before exploring further.
List Assets
Fetch a paginated list of assets with filtering, sorting, and search.
query GetAssets(
$type: String
$tags: [String!]
$search: String
$filter: AssetFilter
$sort: [SortCriteria!]
$cursor: String
$limit: Int
) {
assets(
type: $type
tags: $tags
search: $search
filter: $filter
sort: $sort
cursor: $cursor
limit: $limit
) {
data {
id
name
type
url
size
width
height
tags
}
pagination {
cursor
hasMore
limit
}
}
}
Parameters
| Parameter | Type | Default | Description |
|---|
type | String | - | Filter by MIME type |
tags | [String!] | - | Filter by tags (AND logic) |
search | String | - | Search in name and description |
filter | AssetFilter | - | Advanced field filtering |
sort | [SortCriteria!] | - | Sort criteria |
cursor | String | null | Cursor for pagination |
limit | Int | 20 | Items per page |
Filter Example
query {
assets(
type: "image/jpeg"
tags: ["hero"]
filter: {
name: { like: "%banner%" }
size: { lte: 500000 }
}
sort: [{ field: "updatedAt", order: DESC }]
limit: 10
) {
data {
id
name
type
url
size
width
height
tags
}
pagination {
cursor
hasMore
}
}
}
Response:
{
"data": {
"assets": {
"data": [
{
"id": "asset123",
"name": "hero-banner.jpg",
"type": "image/jpeg",
"url": "https://cdn.metabind.ai/assets/hero-banner.jpg",
"size": 245000,
"width": 1920,
"height": 1080,
"tags": ["hero", "banner"]
}
],
"pagination": {
"cursor": null,
"hasMore": false
}
}
}
}
Get Single Asset
Fetch a specific asset by ID.
query GetAsset($id: ID!) {
asset(id: $id) {
id
name
description
type
url
size
width
height
tags
createdAt
updatedAt
}
}
Parameters
| Parameter | Type | Required | Description |
|---|
id | ID! | Yes | Asset ID |
Example
query {
asset(id: "asset123") {
id
name
type
url
size
width
height
}
}
Response:
{
"data": {
"asset": {
"id": "asset123",
"name": "hero-banner.jpg",
"type": "image/jpeg",
"url": "https://cdn.metabind.ai/assets/hero-banner.jpg",
"size": 245000,
"width": 1920,
"height": 1080
}
}
}
Asset Fields
| Field | Type | Description |
|---|
id | ID! | Unique identifier |
name | String! | File name |
description | String! | Asset description |
type | String! | MIME type |
url | String! | CDN URL |
size | Int! | File size in bytes |
width | Int | Image width (images only) |
height | Int | Image height (images only) |
tags | [String!]! | Associated tags |
createdAt | DateTime! | Upload timestamp |
updatedAt | DateTime! | Last update timestamp |
Common MIME Types
| Type | Description |
|---|
image/jpeg | JPEG images |
image/png | PNG images |
image/gif | GIF images |
image/webp | WebP images |
image/svg+xml | SVG graphics |
video/mp4 | MP4 videos |
video/webm | WebM videos |
application/pdf | PDF documents |