Skip to main content
GET
/
app
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
assets
curl -X GET "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/assets?type=image/jpeg&status=active&limit=20" \
  -H "Authorization: Bearer YOUR_JWT"
{
  "data": [
    {
      "id": "asset123",
      "name": "hero-image.jpg",
      "description": "Hero banner image for homepage",
      "type": "image/jpeg",
      "status": "active",
      "url": "https://cdn.metabind.ai/org123/proj456/assets/asset123/hero-image.jpg",
      "size": 2048576,
      "metadata": {
        "width": 1920,
        "height": 1080,
        "format": "jpeg"
      },
      "tags": ["hero", "homepage"],
      "createdAt": "2024-03-20T10:00:00Z",
      "updatedAt": "2024-03-20T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "lastKey": "eyJpZCI6ImFzc2V0MTIzIn0="
  }
}
Retrieve a paginated list of assets in a project. Supports filtering by type, status, tags, and date ranges.

Path Parameters

organizationId
string
required
The unique identifier of the organization
projectId
string
required
The unique identifier of the project

Query Parameters

page
number
default:"1"
Page number for pagination
limit
number
default:"20"
Number of items per page (max: 100)
type
string
Filter by MIME type (e.g., image/jpeg, video/mp4)
tags
string
Filter by tags (comma-separated list of tag IDs)
status
string
Filter by status: active or deleted
Search term for name and description
sort
string
default:"updatedAt:desc"
Sort field and direction (e.g., name:asc, createdAt:desc)
from
string
Created date range start (ISO 8601 format)
to
string
Created date range end (ISO 8601 format)

Response

data
Asset[]
Array of asset objects
pagination
object
curl -X GET "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/assets?type=image/jpeg&status=active&limit=20" \
  -H "Authorization: Bearer YOUR_JWT"
{
  "data": [
    {
      "id": "asset123",
      "name": "hero-image.jpg",
      "description": "Hero banner image for homepage",
      "type": "image/jpeg",
      "status": "active",
      "url": "https://cdn.metabind.ai/org123/proj456/assets/asset123/hero-image.jpg",
      "size": 2048576,
      "metadata": {
        "width": 1920,
        "height": 1080,
        "format": "jpeg"
      },
      "tags": ["hero", "homepage"],
      "createdAt": "2024-03-20T10:00:00Z",
      "updatedAt": "2024-03-20T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "lastKey": "eyJpZCI6ImFzc2V0MTIzIn0="
  }
}