Skip to main content
POST
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
saved-searches
/
{id}
/
execute
Execute Saved Search
curl --request POST \
  --url https://api.example.com/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute
Executes a saved search using its stored filter and sort criteria, returning matching content or assets based on the search type.

​
Path Parameters

​
organizationId
string
required
Organization ID
​
projectId
string
required
Project ID
​
id
string
required
Saved search ID

​
Query Parameters

​
page
number
Page number (default: 1)
​
limit
number
Items per page (default: 20)

​
Execution Behavior

When executing a saved search:
  1. The saved search’s filter and sort parameters are applied
  2. The type field determines whether the search targets content or assets
  3. Additional query parameters in the execute request are merged with the saved filter
  4. Results are paginated according to the page and limit parameters
  5. The search’s metadata.lastUsed and metadata.useCount are updated

​
Response (Content Type)

When the saved search type is content: 
{
  "data": [
    {
      "id": "cont123",
      "name": "Getting Started with Metabind",
      "typeId": "article",
      "status": "draft",
      "createdAt": "2024-03-20T10:00:00Z",
      "updatedAt": "2024-03-21T15:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "pages": 3
  },
  "savedSearch": {
    "id": "ss123",
    "name": "Draft Articles"
  }
}

​
Response (Asset Type)

When the saved search type is asset: 
{
  "data": [
    {
      "id": "asset123",
      "name": "hero-image.jpg",
      "type": "image/jpeg",
      "size": 245760,
      "createdAt": "2024-03-20T10:00:00Z",
      "updatedAt": "2024-03-21T15:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 15,
    "pages": 1
  },
  "savedSearch": {
    "id": "ss124",
    "name": "Recent Images"
  }
}

​
Error Responses

​
Saved Search Not Found

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Saved search not found"
  }
}

​
Code Examples

curl -X POST "https://api.metabind.ai/v1/organizations/org123/projects/proj456/saved-searches/ss123/execute?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"