Skip to main content
GET
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
folders
List Folders
curl --request GET \
  --url https://api.example.com/v1/organizations/{organizationId}/projects/{projectId}/folders
{
  "data": [
    {}
  ],
  "pagination": {}
}

​
Path Parameters

​
organizationId
string
required
Organization ID
​
projectId
string
required
Project ID

​
Query Parameters

​
parentId
string
Filter by parent folder (null for root level)
​
type
string
Filter by folder type: content or asset
​
recursive
boolean
default:"false"
Include all descendant folders
​
page
number
default:"1"
Page number
​
limit
number
default:"20"
Items per page

​
Response

​
data
Folder[]
Array of folder objects
​
pagination
object
Pagination information

​
Example Response

{
  "data": [
    {
      "id": "folder123",
      "name": "Marketing Content Searches",
      "parentId": null,
      "type": "content",
      "order": 1.0,
      "createdAt": "2024-03-20T10:00:00Z",
      "updatedAt": "2024-03-20T10:00:00Z"
    },
    {
      "id": "folder456",
      "name": "Image Asset Searches",
      "parentId": null,
      "type": "asset",
      "order": 2.0,
      "createdAt": "2024-03-20T10:00:00Z",
      "updatedAt": "2024-03-20T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "pages": 1
  }
}

​
Code Examples

curl -X GET "https://api.metabind.ai/v1/organizations/org123/projects/proj456/folders?type=content" \
  -H "Authorization: Bearer YOUR_API_KEY"