Execute Saved Search

curl --request POST \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute

import requests

url = "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute"

response = requests.post(url)

print(response.text)

const options = {method: 'POST'};

fetch('https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

POST

app

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

import requests

url = "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute"

response = requests.post(url)

print(response.text)

const options = {method: 'POST'};

fetch('https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/saved-searches/{id}/execute")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

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

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:

The saved search’s filter and sort parameters are applied
The type field determines whether the search targets content or assets
Additional query parameters in the execute request are merged with the saved filter
Results are paginated according to the page and limit parameters
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"

const response = await fetch(
  'https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/saved-searches/ss123/execute?limit=10',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_JWT'
    }
  }
);

const { data, pagination, searchInfo } = await response.json();
console.log(`Found ${data.length} results for "${searchInfo.name}"`);

var request = URLRequest(url: URL(string: "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/saved-searches/ss123/execute?limit=10")!)
request.httpMethod = "POST"
request.setValue("Bearer YOUR_JWT", forHTTPHeaderField: "Authorization")

let (data, _) = try await URLSession.shared.data(for: request)
let result = try JSONDecoder().decode(SearchExecutionResponse.self, from: data)
print("Found \(result.data.count) results")

val response = client.post("https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/saved-searches/ss123/execute") {
    header("Authorization", "Bearer YOUR_JWT")
    parameter("limit", 10)
}

val result = response.body<SearchExecutionResponse>()
println("Found ${result.data.size} results for ${result.searchInfo.name}")

Delete Saved Search Toggle Favorite

​Path Parameters

​Query Parameters

​Execution Behavior

​Response (Content Type)

​Response (Asset Type)

​Error Responses

​Saved Search Not Found

​Code Examples

Path Parameters

Query Parameters

Execution Behavior

Response (Content Type)

Response (Asset Type)

Error Responses

Saved Search Not Found

Code Examples