Search

Simple search for file names folders, collections, individuals, and views

post

Unified simple search endpoint that searches across assets, folders, collections, individuals, and views.

This endpoint provides a lightweight search that:

  • Searches assets by name

  • Searches folders by directory name

  • Searches collections by name

  • Searches individuals (face groups) by name

  • Searches dynamic views by name

  • Returns a unified list ranked by match quality (exact > prefix > contains > similarity)

Unlike the main search endpoint, this does not perform AI-powered search or semantic search. It's designed for fast, simple name-based lookups across all searchable entities in the drive.

Header parameters
passwordany ofOptional

The password header to use to fetch the preview

stringOptional
or
nullOptional
Body
querystringRequired

The query to search for across all entity types.

drive_idstring · uuidRequired

The id of the drive to search in.

limitintegerOptional

The maximum total number of results to return across all entity types. Defaults to 50.

Default: 50
offsetintegerOptional

The offset for pagination. Defaults to 0.

Default: 0
entity_typesany ofOptional

Optional list of entity types to search. If not provided, searches all types.

or
nullOptional
Responses
chevron-right
200

Unified search results ranked by relevance

application/json
post
/search/simple

Track a search result selection for personalized ranking

post

Track when a user selects a search result to improve future search rankings.

This endpoint records which search results users click on, allowing the system to boost frequently selected results to the top of future searches for the same query.

Requires authentication.

Header parameters
passwordany ofOptional

The password header to use to fetch the preview

stringOptional
or
nullOptional
Body
querystringRequired

The search query that was performed

entity_typestring · enumRequired

Type of entity selected

Possible values:
entity_idany ofOptional

ID of the selected entity (null for folders)

string · uuidOptional
or
nullOptional
pathany ofOptional

Path of the selected entity (for folders)

stringOptional
or
nullOptional
drive_idstring · uuidRequired

Drive where the search occurred

Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/search/simple/ranking

No content

Reset personalized search rankings

post

Reset personalized search ranking data for a user.

If a query is provided, only rankings for that specific query are reset. Otherwise, all search rankings for the user in the specified drive are reset.

Requires authentication.

Header parameters
passwordany ofOptional

The password header to use to fetch the preview

stringOptional
or
nullOptional
Body
drive_idstring · uuidRequired

Drive to reset rankings for

queryany ofOptional

Optional specific query to reset. If not provided, resets all queries.

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/search/simple/ranking/reset

No content

Get recent unique search queries for the current user

get

Get the most recent unique search queries for the current user.

Returns queries ordered by the most recent selection time across any result for that query. Useful for showing search history or suggested searches.

Requires authentication.

Query parameters
drive_idstring · uuidRequired

The id of the drive to get recent queries for

limitintegerOptional

Maximum number of recent queries to return. Defaults to 10.

Default: 10
Header parameters
passwordany ofOptional

The password header to use to fetch the preview

stringOptional
or
nullOptional
Body
Responses
chevron-right
200

Successful Response

application/json
Responseany
get
/search/simple/queries/recent

No content

Search for assets. Note: This request is idempotent

post

Search for assets in the database. This is the primary search function on assets.

If collection_id is provided, the search is restricted to that collection. Otherwise, the search is performed on the entire drive.

This route should not be called for searching on a public path - use /search/files instead.

Header parameters
passwordany ofOptional

The password header to use to fetch the preview

stringOptional
or
nullOptional
Body
queryany ofOptional

The query to search for. If not provided, all assets will be returned.

stringOptional
or
nullOptional
filtersany ofOptional

The filters that you want to apply to your search.

or
nullOptional
similar_asset_idany ofOptional

The id of the asset to find similar assets to.

string · uuidOptional
or
nullOptional
sortany ofOptional

A field name, optionally prefixed by the - sign to specify a descending order.

stringOptional
or
nullOptional
offsetany ofOptional

The offset of results to return. Input either this or 'page'. Defaults to 0 if neither are inputted.

integerOptional
or
nullOptional
pageany ofOptional

The page of results to return. Input either this or offset. Defaults to 0 if neither are inputted.

integerOptional
or
nullOptional
limitany ofOptional

The maximum number of assets to return. Defaults to 100.

Default: 100
integerOptional
or
nullOptional
drive_idstring · uuidRequired

The id of the drive we want to search on.

return_only_attrsany ofOptional

The attributes that you want to return. If not provided, all attributes will be returned. This is limited, and not all attributes that exist on AssetDTO will work.

Default: []
string[]Optional
or
nullOptional
collection_idany ofOptional

The id of the collection to search within.

string · uuidOptional
or
nullOptional
Responses
chevron-right
200

A list of matching assets

application/json
post
/search

Chunk enabled version of search above

post

Search for subclips using columnar search engine. Returns assets with their associated chunks.

If collection_id is provided, the search is restricted to that collection. Otherwise, the search is performed on the entire drive.

Header parameters
passwordany ofOptional

The password header to use to fetch the preview

stringOptional
or
nullOptional
Body
querystringRequired

The query to search for subclips.

filtersany ofOptional

The filters that you want to apply to your search.

or
nullOptional
drive_idstring · uuidRequired

The id of the drive we want to search on.

database_signalsstring[]Optional

The database column signals to search through.

Default: []
signal_weightsany ofOptional

Weights for each database signal (e.g., {'video_chunks': 1.0, 'document_chunks': 0.8}). Default is 1.0 for all.

or
nullOptional
search_modesany ofOptional

Search modes per signal. Each signal can have 'vector' and 'fulltext' modes enabled/disabled. E.g., {'video_chunks': {'vector': True, 'fulltext': False}, 'document_chunks': {'vector': True, 'fulltext': True}}. Default enables both modes where available.

or
nullOptional
merge_chunksbooleanOptional

Whether to merge overlapping/adjacent chunks within the same asset. Disable to see individual chunk segments.

Default: true
video_score_thresholdany ofOptional

Minimum score threshold for video/audio chunks. Chunks below this score are filtered out. Suggested: 0.03

numberOptional
or
nullOptional
document_score_thresholdany ofOptional

Minimum score threshold for document/transcription chunks. Chunks below this score are filtered out. Suggested: 0.35

numberOptional
or
nullOptional
image_score_thresholdany ofOptional

Minimum score threshold for image chunks. Chunks below this score are filtered out. Suggested: 0.02

numberOptional
or
nullOptional
collection_idany ofOptional

The id of the collection to search within.

string · uuidOptional
or
nullOptional
Responses
chevron-right
200

A list of matching assets with chunks

application/json
post
/search/chunked

Get the folders in a folder

get

Get all content in a folder (non-indexed and indexed)

Query parameters
pathstring · pathRequired

The directory path to list items

queryany ofOptional

The query to search for. If not provided, all folder contents will be returned.

stringOptional
or
nullOptional
offsetany ofOptional

The offset of results to return. Input either this or 'page'.

integerOptional
or
nullOptional
pageany ofOptional

The page to query. Input either this or 'offset'.

integerOptional
or
nullOptional
limitany ofOptional

The limit that is fetched per page

integerOptional
or
nullOptional
drive_idstring · uuidRequired

The id of the drive we want to add user to

Header parameters
passwordany ofOptional

The password header to use to fetch the preview

stringOptional
or
nullOptional
Body
Responses
chevron-right
200

Successful Response

application/json
Responsestring · path[]
get
/search/folders

Get the files in a folder

post

Get all files in a folder. This performs a "search" with a filter on the path, and auths on public paths.

Header parameters
passwordany ofOptional

The password header to use to fetch the preview

stringOptional
or
nullOptional
Body
pathstring · pathRequired

The directory path to list items

recursiveany ofOptional

Whether or not to do a recursive search on the directory

Default: false
booleanOptional
or
nullOptional
queryany ofOptional

The query to search for. If not provided, all folder contents will be returned.

stringOptional
or
nullOptional
offsetany ofOptional

The offset of results to return. Input either this or 'page'. Defaults to 0 if neither are inputted.

integerOptional
or
nullOptional
pageany ofOptional

The page to query. Input either this or 'offset'. Defaults to 0 if neither are inputted.

integerOptional
or
nullOptional
limitany ofOptional

The limit that is fetched per page. Defaults to 100

Default: 100
integerOptional
or
nullOptional
filtersany ofOptional

The filters that you want to apply to your search.

or
nullOptional
sortany ofOptional

A field name, optionally prefixed by the - sign to specify a descending order.

stringOptional
or
nullOptional
drive_idstring · uuidRequired

The id of the drive we want to add user to

return_only_attrsany ofOptional

The attributes that you want to return. If not provided, all attributes will be returned. This is limited, and not all attributes that exist on AssetDTO will work.

Default: []
string[]Optional
or
nullOptional
collection_idany ofOptional

The id of the collection (used for custom sort when browsing folders within a collection).

string · uuidOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/search/files

Export search results

post

Export search results to a file. The file is returned as a downloadable response.

If collection_id is provided, the search is restricted to that collection. If path is provided, the search is restricted to that path (includes public path). Otherwise, the search is performed on the entire drive.

Path parameters
export_formatstring · enumRequired

The format that you want to export the search results in.

Possible values:
Query parameters
timezoneany ofOptional
stringOptional
or
nullOptional
Header parameters
passwordany ofOptional

The password header to use to fetch the preview

stringOptional
or
nullOptional
Body
queryany ofOptional

The query to search for.

stringOptional
or
nullOptional
filtersany ofOptional

The filters that you want to apply to your search.

or
nullOptional
sortany ofOptional

A field name, optionally prefixed by the - sign to specify a descending order.

stringOptional
or
nullOptional
offsetany ofOptional

The offset of results to return. Input either this or 'page'. Defaults to 0 if neither are inputted.

integerOptional
or
nullOptional
pageany ofOptional

The page to query. Input either this or 'offset'. Defaults to 0 if neither are inputted.

integerOptional
or
nullOptional
limitany ofOptional

The limit that is fetched per page. Defaults to 100

Default: 100
integerOptional
or
nullOptional
drive_idstring · uuidRequired

The id of the drive we want to search on.

collection_idany ofOptional

The id of the collection to search within.

string · uuidOptional
or
nullOptional
pathany ofOptional

The directory path to list items under

string · pathOptional
or
nullOptional
recursiveany ofOptional

Whether or not to do a recursive search on the directory

Default: false
booleanOptional
or
nullOptional
share_idany ofOptional

The id of the share to search within

string · uuidOptional
or
nullOptional
metadata_attribute_idsstring[]Required

List of attribute IDs that should be returned (these are the columns in the export)

osany ofOptional

The operating system that the exported file will be used on.

string · enumOptional

Operating System Enum from the result of platform.system()

Possible values:
or
nullOptional
Responses
chevron-right
200

A downloadable file

application/json
Responseany
post
/search/exports/{export_format}

No content

Last updated