Skip to main content
GET
/
api
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
assets
curl -X GET "https://api.metabind.ai/api/v1/organizations/org123/projects/proj456/assets?type=image/jpeg&status=active&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

{
  "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,
    "total": 42,
    "pages": 3
  }
}
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)
​
tag
string
Filter by tag ID. Can be repeated for multiple tags.
​
status
string
Filter by status: active or deleted
​
search
string
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/api/v1/organizations/org123/projects/proj456/assets?type=image/jpeg&status=active&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

{
  "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,
    "total": 42,
    "pages": 3
  }
}