Skip to main content
GET
/
app
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
components
List Components
curl --request GET \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components
{
  "data": [
    {}
  ],
  "pagination": {
    "limit": 123,
    "lastKey": "<string>"
  }
}

​
Query Parameters

​
limit
number
default:"10"
Items per page
​
lastKey
string
Cursor for pagination (from previous response)
​
type
string
Filter by component type: view or layout
​
search
string
Search term for name
​
query
string
Semantic search query
​
includeAssets
boolean
default:"false"
Include component assets inline in the response

​
Response

​
data
Component[]
Array of component objects
​
pagination
object

​
Example Response

{
  "data": [
    {
      "id": "c123",
      "name": "ArticleLayout",
      "title": "Article Layout",
      "description": "Standard article layout...",
      "type": "layout",
      "status": "published",
      "version": 3,
      "lastPublishedVersion": 3,
      "content": "...",
      "compiled": "...",
      "schema": {...},
      "createdAt": "2024-03-20T10:00:00Z",
      "updatedAt": "2024-03-21T14:30:00Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "lastKey": "eyJpZCI6ImMxMjQifQ=="
  }
}

​
Response with Assets

When includeAssets=true: 
{
  "data": [
    {
      "id": "c123",
      "name": "ArticleLayout",
      "type": "layout",
      "status": "published",
      "assets": [
        {
          "id": "asset123",
          "name": "hero-image.jpg",
          "type": "image/jpeg",
          "url": "https://cdn.metabind.ai/.../hero-image.jpg",
          "size": 2048576,
          "status": "active",
          "metadata": {
            "width": 1920,
            "height": 1080
          }
        }
      ],
      "createdAt": "2024-03-20T10:00:00Z",
      "updatedAt": "2024-03-21T14:30:00Z"
    }
  ],
  "pagination": {...}
}
When includeAssets=true, only the first 100 assets per component are included.

​
Code Examples

curl -X GET "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/components?status=published&type=layout" \
  -H "Authorization: Bearer YOUR_JWT"