Skip to main content
POST
/
app
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
saved-searches
/
{id}
/
execute
Execute Saved Search
curl --request POST \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute

Documentation Index

Fetch the complete documentation index at: https://docs.metabind.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
limit
number
Items per page (default: 20)
​
lastKey
string
Cursor for pagination (from previous response)

​
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": {
    "lastKey": "eyJpZCI6ImNvbnQxMjMifQ=="
  },
  "searchInfo": {
    "id": "ss123",
    "name": "Draft Articles",
    "type": "content",
    "executedAt": "2024-03-22T10:00:00Z"
  }
}

​
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": {
    "lastKey": "eyJpZCI6ImFzc2V0MTIzIn0="
  },
  "searchInfo": {
    "id": "ss124",
    "name": "Recent Images",
    "type": "asset",
    "executedAt": "2024-03-22T10:00:00Z"
  }
}

​
Error Responses

​
Saved Search Not Found

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

​
Code Examples

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