List Objects

curl --request POST \
  --url https://api.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "AND": [
      {
        "field": "name",
        "operator": "eq",
        "value": "John"
      },
      {
        "field": "age",
        "operator": "gte",
        "value": 30
      }
    ],
    "OR": [
      {
        "field": "status",
        "operator": "eq",
        "value": "active"
      },
      {
        "field": "role",
        "operator": "eq",
        "value": "admin"
      }
    ],
    "NOT": [
      {
        "field": "department",
        "operator": "eq",
        "value": "HR"
      },
      {
        "field": "location",
        "operator": "eq",
        "value": "remote"
      }
    ],
    "case_sensitive": true
  },
  "sort": {
    "field": "created_at",
    "direction": "desc"
  },
  "search": "<string>",
  "select": [
    "metadata",
    "status",
    "created_at"
  ],
  "return_presigned_urls": false
}
'

import requests

url = "https://api.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list"

payload = {
    "filters": {
        "AND": [
            {
                "field": "name",
                "operator": "eq",
                "value": "John"
            },
            {
                "field": "age",
                "operator": "gte",
                "value": 30
            }
        ],
        "OR": [
            {
                "field": "status",
                "operator": "eq",
                "value": "active"
            },
            {
                "field": "role",
                "operator": "eq",
                "value": "admin"
            }
        ],
        "NOT": [
            {
                "field": "department",
                "operator": "eq",
                "value": "HR"
            },
            {
                "field": "location",
                "operator": "eq",
                "value": "remote"
            }
        ],
        "case_sensitive": True
    },
    "sort": {
        "field": "created_at",
        "direction": "desc"
    },
    "search": "<string>",
    "select": ["metadata", "status", "created_at"],
    "return_presigned_urls": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    filters: {
      AND: [
        {field: 'name', operator: 'eq', value: 'John'},
        {field: 'age', operator: 'gte', value: 30}
      ],
      OR: [
        {field: 'status', operator: 'eq', value: 'active'},
        {field: 'role', operator: 'eq', value: 'admin'}
      ],
      NOT: [
        {field: 'department', operator: 'eq', value: 'HR'},
        {field: 'location', operator: 'eq', value: 'remote'}
      ],
      case_sensitive: true
    },
    sort: {field: 'created_at', direction: 'desc'},
    search: '<string>',
    select: ['metadata', 'status', 'created_at'],
    return_presigned_urls: false
  })
};

fetch('https://api.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list', 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.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filters' => [
        'AND' => [
                [
                                'field' => 'name',
                                'operator' => 'eq',
                                'value' => 'John'
                ],
                [
                                'field' => 'age',
                                'operator' => 'gte',
                                'value' => 30
                ]
        ],
        'OR' => [
                [
                                'field' => 'status',
                                'operator' => 'eq',
                                'value' => 'active'
                ],
                [
                                'field' => 'role',
                                'operator' => 'eq',
                                'value' => 'admin'
                ]
        ],
        'NOT' => [
                [
                                'field' => 'department',
                                'operator' => 'eq',
                                'value' => 'HR'
                ],
                [
                                'field' => 'location',
                                'operator' => 'eq',
                                'value' => 'remote'
                ]
        ],
        'case_sensitive' => true
    ],
    'sort' => [
        'field' => 'created_at',
        'direction' => 'desc'
    ],
    'search' => '<string>',
    'select' => [
        'metadata',
        'status',
        'created_at'
    ],
    'return_presigned_urls' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list"

	payload := strings.NewReader("{\n  \"filters\": {\n    \"AND\": [\n      {\n        \"field\": \"name\",\n        \"operator\": \"eq\",\n        \"value\": \"John\"\n      },\n      {\n        \"field\": \"age\",\n        \"operator\": \"gte\",\n        \"value\": 30\n      }\n    ],\n    \"OR\": [\n      {\n        \"field\": \"status\",\n        \"operator\": \"eq\",\n        \"value\": \"active\"\n      },\n      {\n        \"field\": \"role\",\n        \"operator\": \"eq\",\n        \"value\": \"admin\"\n      }\n    ],\n    \"NOT\": [\n      {\n        \"field\": \"department\",\n        \"operator\": \"eq\",\n        \"value\": \"HR\"\n      },\n      {\n        \"field\": \"location\",\n        \"operator\": \"eq\",\n        \"value\": \"remote\"\n      }\n    ],\n    \"case_sensitive\": true\n  },\n  \"sort\": {\n    \"field\": \"created_at\",\n    \"direction\": \"desc\"\n  },\n  \"search\": \"<string>\",\n  \"select\": [\n    \"metadata\",\n    \"status\",\n    \"created_at\"\n  ],\n  \"return_presigned_urls\": false\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	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.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": {\n    \"AND\": [\n      {\n        \"field\": \"name\",\n        \"operator\": \"eq\",\n        \"value\": \"John\"\n      },\n      {\n        \"field\": \"age\",\n        \"operator\": \"gte\",\n        \"value\": 30\n      }\n    ],\n    \"OR\": [\n      {\n        \"field\": \"status\",\n        \"operator\": \"eq\",\n        \"value\": \"active\"\n      },\n      {\n        \"field\": \"role\",\n        \"operator\": \"eq\",\n        \"value\": \"admin\"\n      }\n    ],\n    \"NOT\": [\n      {\n        \"field\": \"department\",\n        \"operator\": \"eq\",\n        \"value\": \"HR\"\n      },\n      {\n        \"field\": \"location\",\n        \"operator\": \"eq\",\n        \"value\": \"remote\"\n      }\n    ],\n    \"case_sensitive\": true\n  },\n  \"sort\": {\n    \"field\": \"created_at\",\n    \"direction\": \"desc\"\n  },\n  \"search\": \"<string>\",\n  \"select\": [\n    \"metadata\",\n    \"status\",\n    \"created_at\"\n  ],\n  \"return_presigned_urls\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": {\n    \"AND\": [\n      {\n        \"field\": \"name\",\n        \"operator\": \"eq\",\n        \"value\": \"John\"\n      },\n      {\n        \"field\": \"age\",\n        \"operator\": \"gte\",\n        \"value\": 30\n      }\n    ],\n    \"OR\": [\n      {\n        \"field\": \"status\",\n        \"operator\": \"eq\",\n        \"value\": \"active\"\n      },\n      {\n        \"field\": \"role\",\n        \"operator\": \"eq\",\n        \"value\": \"admin\"\n      }\n    ],\n    \"NOT\": [\n      {\n        \"field\": \"department\",\n        \"operator\": \"eq\",\n        \"value\": \"HR\"\n      },\n      {\n        \"field\": \"location\",\n        \"operator\": \"eq\",\n        \"value\": \"remote\"\n      }\n    ],\n    \"case_sensitive\": true\n  },\n  \"sort\": {\n    \"field\": \"created_at\",\n    \"direction\": \"desc\"\n  },\n  \"search\": \"<string>\",\n  \"select\": [\n    \"metadata\",\n    \"status\",\n    \"created_at\"\n  ],\n  \"return_presigned_urls\": false\n}"

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

{
  "results": [
    {
      "bucket_id": "<string>",
      "object_id": "<string>",
      "key_prefix": "<string>",
      "blobs": [
        {
          "property": "<string>",
          "blob_id": "<string>",
          "key_prefix": "/videos/video.mp4",
          "properties": {},
          "presigned_url": "<string>",
          "details": {
            "filename": "<string>",
            "size_bytes": 123,
            "mime_type": "<string>",
            "hash": "<string>"
          }
        }
      ],
      "source_details": [
        {
          "source_id": "<string>"
        }
      ],
      "edges": [
        {
          "type": "<string>",
          "target_object_id": "<string>",
          "target_collection_id": "<string>",
          "direction": "out",
          "attributes": {}
        }
      ],
      "status": "DRAFT",
      "error": "Failed to process object: Object not found",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "document_count": 123,
      "consistency": {
        "retriever_visible": "<string>",
        "recommended_header": "<string>",
        "write_token_available": false,
        "expected_visible_within_ms": 123,
        "poll": {},
        "next_actions": [
          {}
        ]
      }
    }
  ],
  "pagination": {
    "total": 123,
    "page": 123,
    "page_size": 123,
    "total_pages": 123,
    "next_page": "<string>",
    "previous_page": "<string>",
    "next_cursor": "<string>"
  },
  "stats": {
    "total_objects": 0,
    "total_blobs": 0,
    "avg_blobs_per_object": 0,
    "objects_by_status": {}
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

Objects

List Objects

This endpoint lists objects in a bucket with cursor-based pagination, filtering, and sorting.

Filtering: Use dot notation for metadata fields

Example: ?metadata.type=video&metadata.status=ready

Sorting: Specify field and direction

Example: ?sort_field=metadata.created_at&sort_direction=desc
Direction: asc (ascending) or desc (descending), defaults to asc

Pagination: Cursor-based for efficient deep pagination

First page: ?limit=100 (omit cursor)
Next pages: ?limit=100&cursor=
Use next_cursor from response to navigate
No limit on pagination depth

Total Count: Optional (expensive operation)

Use ?include_total=true to get total count
Adds 50-200ms to response time
Returns total, page, page_size, total_pages fields in pagination response

POST

buckets

{bucket_identifier}

objects

list

List Objects

curl --request POST \
  --url https://api.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "AND": [
      {
        "field": "name",
        "operator": "eq",
        "value": "John"
      },
      {
        "field": "age",
        "operator": "gte",
        "value": 30
      }
    ],
    "OR": [
      {
        "field": "status",
        "operator": "eq",
        "value": "active"
      },
      {
        "field": "role",
        "operator": "eq",
        "value": "admin"
      }
    ],
    "NOT": [
      {
        "field": "department",
        "operator": "eq",
        "value": "HR"
      },
      {
        "field": "location",
        "operator": "eq",
        "value": "remote"
      }
    ],
    "case_sensitive": true
  },
  "sort": {
    "field": "created_at",
    "direction": "desc"
  },
  "search": "<string>",
  "select": [
    "metadata",
    "status",
    "created_at"
  ],
  "return_presigned_urls": false
}
'

import requests

url = "https://api.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list"

payload = {
    "filters": {
        "AND": [
            {
                "field": "name",
                "operator": "eq",
                "value": "John"
            },
            {
                "field": "age",
                "operator": "gte",
                "value": 30
            }
        ],
        "OR": [
            {
                "field": "status",
                "operator": "eq",
                "value": "active"
            },
            {
                "field": "role",
                "operator": "eq",
                "value": "admin"
            }
        ],
        "NOT": [
            {
                "field": "department",
                "operator": "eq",
                "value": "HR"
            },
            {
                "field": "location",
                "operator": "eq",
                "value": "remote"
            }
        ],
        "case_sensitive": True
    },
    "sort": {
        "field": "created_at",
        "direction": "desc"
    },
    "search": "<string>",
    "select": ["metadata", "status", "created_at"],
    "return_presigned_urls": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    filters: {
      AND: [
        {field: 'name', operator: 'eq', value: 'John'},
        {field: 'age', operator: 'gte', value: 30}
      ],
      OR: [
        {field: 'status', operator: 'eq', value: 'active'},
        {field: 'role', operator: 'eq', value: 'admin'}
      ],
      NOT: [
        {field: 'department', operator: 'eq', value: 'HR'},
        {field: 'location', operator: 'eq', value: 'remote'}
      ],
      case_sensitive: true
    },
    sort: {field: 'created_at', direction: 'desc'},
    search: '<string>',
    select: ['metadata', 'status', 'created_at'],
    return_presigned_urls: false
  })
};

fetch('https://api.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list', 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.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filters' => [
        'AND' => [
                [
                                'field' => 'name',
                                'operator' => 'eq',
                                'value' => 'John'
                ],
                [
                                'field' => 'age',
                                'operator' => 'gte',
                                'value' => 30
                ]
        ],
        'OR' => [
                [
                                'field' => 'status',
                                'operator' => 'eq',
                                'value' => 'active'
                ],
                [
                                'field' => 'role',
                                'operator' => 'eq',
                                'value' => 'admin'
                ]
        ],
        'NOT' => [
                [
                                'field' => 'department',
                                'operator' => 'eq',
                                'value' => 'HR'
                ],
                [
                                'field' => 'location',
                                'operator' => 'eq',
                                'value' => 'remote'
                ]
        ],
        'case_sensitive' => true
    ],
    'sort' => [
        'field' => 'created_at',
        'direction' => 'desc'
    ],
    'search' => '<string>',
    'select' => [
        'metadata',
        'status',
        'created_at'
    ],
    'return_presigned_urls' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list"

	payload := strings.NewReader("{\n  \"filters\": {\n    \"AND\": [\n      {\n        \"field\": \"name\",\n        \"operator\": \"eq\",\n        \"value\": \"John\"\n      },\n      {\n        \"field\": \"age\",\n        \"operator\": \"gte\",\n        \"value\": 30\n      }\n    ],\n    \"OR\": [\n      {\n        \"field\": \"status\",\n        \"operator\": \"eq\",\n        \"value\": \"active\"\n      },\n      {\n        \"field\": \"role\",\n        \"operator\": \"eq\",\n        \"value\": \"admin\"\n      }\n    ],\n    \"NOT\": [\n      {\n        \"field\": \"department\",\n        \"operator\": \"eq\",\n        \"value\": \"HR\"\n      },\n      {\n        \"field\": \"location\",\n        \"operator\": \"eq\",\n        \"value\": \"remote\"\n      }\n    ],\n    \"case_sensitive\": true\n  },\n  \"sort\": {\n    \"field\": \"created_at\",\n    \"direction\": \"desc\"\n  },\n  \"search\": \"<string>\",\n  \"select\": [\n    \"metadata\",\n    \"status\",\n    \"created_at\"\n  ],\n  \"return_presigned_urls\": false\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	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.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": {\n    \"AND\": [\n      {\n        \"field\": \"name\",\n        \"operator\": \"eq\",\n        \"value\": \"John\"\n      },\n      {\n        \"field\": \"age\",\n        \"operator\": \"gte\",\n        \"value\": 30\n      }\n    ],\n    \"OR\": [\n      {\n        \"field\": \"status\",\n        \"operator\": \"eq\",\n        \"value\": \"active\"\n      },\n      {\n        \"field\": \"role\",\n        \"operator\": \"eq\",\n        \"value\": \"admin\"\n      }\n    ],\n    \"NOT\": [\n      {\n        \"field\": \"department\",\n        \"operator\": \"eq\",\n        \"value\": \"HR\"\n      },\n      {\n        \"field\": \"location\",\n        \"operator\": \"eq\",\n        \"value\": \"remote\"\n      }\n    ],\n    \"case_sensitive\": true\n  },\n  \"sort\": {\n    \"field\": \"created_at\",\n    \"direction\": \"desc\"\n  },\n  \"search\": \"<string>\",\n  \"select\": [\n    \"metadata\",\n    \"status\",\n    \"created_at\"\n  ],\n  \"return_presigned_urls\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mixpeek.com/v1/buckets/{bucket_identifier}/objects/list")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": {\n    \"AND\": [\n      {\n        \"field\": \"name\",\n        \"operator\": \"eq\",\n        \"value\": \"John\"\n      },\n      {\n        \"field\": \"age\",\n        \"operator\": \"gte\",\n        \"value\": 30\n      }\n    ],\n    \"OR\": [\n      {\n        \"field\": \"status\",\n        \"operator\": \"eq\",\n        \"value\": \"active\"\n      },\n      {\n        \"field\": \"role\",\n        \"operator\": \"eq\",\n        \"value\": \"admin\"\n      }\n    ],\n    \"NOT\": [\n      {\n        \"field\": \"department\",\n        \"operator\": \"eq\",\n        \"value\": \"HR\"\n      },\n      {\n        \"field\": \"location\",\n        \"operator\": \"eq\",\n        \"value\": \"remote\"\n      }\n    ],\n    \"case_sensitive\": true\n  },\n  \"sort\": {\n    \"field\": \"created_at\",\n    \"direction\": \"desc\"\n  },\n  \"search\": \"<string>\",\n  \"select\": [\n    \"metadata\",\n    \"status\",\n    \"created_at\"\n  ],\n  \"return_presigned_urls\": false\n}"

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

{
  "results": [
    {
      "bucket_id": "<string>",
      "object_id": "<string>",
      "key_prefix": "<string>",
      "blobs": [
        {
          "property": "<string>",
          "blob_id": "<string>",
          "key_prefix": "/videos/video.mp4",
          "properties": {},
          "presigned_url": "<string>",
          "details": {
            "filename": "<string>",
            "size_bytes": 123,
            "mime_type": "<string>",
            "hash": "<string>"
          }
        }
      ],
      "source_details": [
        {
          "source_id": "<string>"
        }
      ],
      "edges": [
        {
          "type": "<string>",
          "target_object_id": "<string>",
          "target_collection_id": "<string>",
          "direction": "out",
          "attributes": {}
        }
      ],
      "status": "DRAFT",
      "error": "Failed to process object: Object not found",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "document_count": 123,
      "consistency": {
        "retriever_visible": "<string>",
        "recommended_header": "<string>",
        "write_token_available": false,
        "expected_visible_within_ms": 123,
        "poll": {},
        "next_actions": [
          {}
        ]
      }
    }
  ],
  "pagination": {
    "total": 123,
    "page": 123,
    "page_size": 123,
    "total_pages": 123,
    "next_page": "<string>",
    "previous_page": "<string>",
    "next_cursor": "<string>"
  },
  "stats": {
    "total_objects": 0,
    "total_blobs": 0,
    "avg_blobs_per_object": 0,
    "objects_by_status": {}
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

bucket_identifier

string

required

The unique identifier of the bucket.

Query Parameters

limit

integer | null

Required range: 1 <= x <= 1000

page_size

integer | null

Required range: 1 <= x <= 1000

offset

integer | null

Required range: 0 <= x <= 10000

page

integer | null

Required range: x >= 1

cursor

string | null

include_total

boolean

default:false

Body

application/json

Request model for listing objects in a bucket.

filters

LogicalOperator · object | null

Filters to apply to the object list

Show child attributes

sort

SortOption · object | null

Sort options for the object list

Show child attributes

string | null

Search term to filter objects by key or metadata

select

string[] | null

OPTIONAL. List of fields to include in the response. Supports dot notation for nested fields (e.g., 'metadata.title', 'status'). When specified, only the selected fields will be returned in the object results, reducing response size. System fields like 'object_id' and 'bucket_id' are always included. Use this to optimize response size when working with large objects.

Example:

["metadata", "status", "created_at"]

return_presigned_urls

boolean | null

default:false

Generate fresh presigned download URLs for all blobs with S3 storage. When true, each blob will include a 'presigned_url' in its properties. URLs expire after 1 hour.

Response

Successful Response

Response model for listing objects in a bucket.

results

ObjectResponse · object[]

required

List of objects matching the query

Show child attributes

pagination

PaginationResponse · object

required

Pagination information

Show child attributes

stats

ObjectListStats · object | null

Aggregate statistics across all objects in the result

Show child attributes

Partially Update Object Aggregate Objects

Organization

Namespaces

Buckets

Feature Extractors

Batch Queue

Collections

Documents

Retrievers

Taxonomies

Clusters

Triggers

Alerts

Webhooks

Apps

Agent Sessions

Annotations

Templates

Manifest

Discovery

Analytics

Notifications

Tasks

Inference

Resource Search

Pricing

List Objects

Authorizations

Path Parameters

Query Parameters

Body

Response