Files

Search files

Semantic vector search over your files. Embeds the query text and returns the closest matching files ranked by cosine similarity. Only files with indexed descriptions are searchable.

post/v1/files/search

Request body

querystring required

Natural-language search query. The text is embedded and compared against file description vectors using cosine similarity.

numResultsinteger

Number of results to return (1-100). Defaults to 10.

selfOnlyboolean

When true, only files created by the calling API key's user are returned. When false (default), all files accessible to the team are included.

Response

Search results ordered by descending similarity

Example response

{
  "results": [
    {
      "similarity": 0.82
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.