Skip to content

Retrievers

Create Retriever
Retriever Retrievers.Create(RetrieverCreateParamsparameters, CancellationTokencancellationToken = default)
POST/api/v1/retrievers
Upsert Retriever
Retriever Retrievers.Upsert(RetrieverUpsertParamsparameters, CancellationTokencancellationToken = default)
PUT/api/v1/retrievers
List Retrievers
IReadOnlyList<Retriever> Retrievers.List(RetrieverListParams?parameters, CancellationTokencancellationToken = default)
GET/api/v1/retrievers
Get Retriever
Retriever Retrievers.Get(RetrieverGetParamsparameters, CancellationTokencancellationToken = default)
GET/api/v1/retrievers/{retriever_id}
Update Retriever
Retriever Retrievers.Update(RetrieverUpdateParamsparameters, CancellationTokencancellationToken = default)
PUT/api/v1/retrievers/{retriever_id}
Delete Retriever
Retrievers.Delete(RetrieverDeleteParamsparameters, CancellationTokencancellationToken = default)
DELETE/api/v1/retrievers/{retriever_id}
Direct Retrieve
CompositeRetrievalResult Retrievers.Search(RetrieverSearchParamsparameters, CancellationTokencancellationToken = default)
POST/api/v1/retrievers/retrieve
ModelsExpand Collapse
enum CompositeRetrievalMode:

Enum for the mode of composite retrieval.

"full"Full
"routing"Routing
class CompositeRetrievalResult:
DeprecatedIReadOnlyList<PageScreenshotNodeWithScore> ImageNodes

The image nodes retrieved by the pipeline for the given query. Deprecated - will soon be replaced with ‘page_screenshot_nodes’.

required Node Node
required string FileID

The ID of the file that the page screenshot was taken from

formatuuid
required Long ImageSize

The size of the image in bytes

minimum0
required Long PageIndex

The index of the page for which the screenshot is taken (0-indexed)

minimum0
IReadOnlyDictionary<string, JsonElement>? Metadata

Metadata for the screenshot

required Double Score

The score of the screenshot node

string ClassName
IReadOnlyList<Node> Nodes

The retrieved nodes from the composite retrieval.

required Node Node
required string ID

The ID of the retrieved node.

formatuuid
required Long? EndCharIdx

The end character index of the retrieved node in the document

required string PipelineID

The ID of the pipeline this node was retrieved from.

formatuuid
required string RetrieverID

The ID of the retriever this node was retrieved from.

formatuuid
required string RetrieverPipelineName

The name of the retrieval pipeline this node was retrieved from.

required Long? StartCharIdx

The start character index of the retrieved node in the document

required string Text

The text of the retrieved node.

IReadOnlyDictionary<string, JsonElement> Metadata

Metadata associated with the retrieved node.

string ClassName
Double? Score
IReadOnlyList<PageFigureNodeWithScore> PageFigureNodes

The page figure nodes retrieved by the pipeline for the given query.

required Node Node
required Double Confidence

The confidence of the figure

maximum1
minimum0
required string FigureName

The name of the figure

required Long FigureSize

The size of the figure in bytes

minimum0
required string FileID

The ID of the file that the figure was taken from

formatuuid
required Long PageIndex

The index of the page for which the figure is taken (0-indexed)

minimum0
Boolean IsLikelyNoise

Whether the figure is likely to be noise

IReadOnlyDictionary<string, JsonElement>? Metadata

Metadata for the figure

required Double Score

The score of the figure node

string ClassName
class ReRankConfig:
Long TopN

The number of nodes to retrieve after reranking over retrieved nodes from all retrieval tools.

minimum1
Type Type

The type of reranker to use.

One of the following:
"bedrock"Bedrock
"cohere"Cohere
"disabled"Disabled
"llm"Llm
"score"Score
"system_default"SystemDefault
class Retriever:

An entity that retrieves context nodes from several sub RetrieverTools.

required string ID

Unique identifier

formatuuid
required string Name

A name for the retriever tool. Will default to the pipeline name if not provided.

maxLength3000
minLength1
required string ProjectID

The ID of the project this retriever resides in.

formatuuid
DateTimeOffset? CreatedAt

Creation datetime

formatdate-time
IReadOnlyList<RetrieverPipeline> Pipelines

The pipelines this retriever uses.

required string? Description

A description of the retriever tool.

maxLength15000
required string? Name

A name for the retriever tool. Will default to the pipeline name if not provided.

maxLength3000
minLength1
required string PipelineID

The ID of the pipeline this tool uses.

formatuuid
PresetRetrievalParams PresetRetrievalParameters

Parameters for retrieval configuration.

Double? Alpha

Alpha value for hybrid retrieval to determine the weights between dense and sparse retrieval. 0 is sparse retrieval and 1 is dense retrieval.

maximum1
minimum0
string ClassName
Double? DenseSimilarityCutoff

Minimum similarity score wrt query for retrieval

maximum1
minimum0
Long? DenseSimilarityTopK

Number of nodes for dense retrieval.

maximum100
minimum1
Boolean? EnableReranking

Enable reranking for retrieval

Long? FilesTopK

Number of files to retrieve (only for retrieval mode files_via_metadata and files_via_content).

maximum5
minimum1
Long? RerankTopN

Number of reranked nodes for returning.

maximum100
minimum1
RetrievalMode RetrievalMode

The retrieval mode for the query.

One of the following:
"auto_routed"AutoRouted
"chunks"Chunks
"files_via_content"FilesViaContent
"files_via_metadata"FilesViaMetadata
DeprecatedBoolean RetrieveImageNodes

Whether to retrieve image nodes.

Boolean RetrievePageFigureNodes

Whether to retrieve page figure nodes.

Boolean RetrievePageScreenshotNodes

Whether to retrieve page screenshot nodes.

MetadataFilters? SearchFilters

Metadata filters for vector stores.

required IReadOnlyList<Filter> Filters
One of the following:
class MetadataFilter:

Comprehensive metadata filter for vector stores to support more operators.

Value uses Strict types, as int, float and str are compatible types and were all converted to string before.

See: https://docs.pydantic.dev/latest/usage/types/#strict-types

required string Key
required Value? Value
One of the following:
Double
string
IReadOnlyList<string>
IReadOnlyList<Double>
IReadOnlyList<Long>
Operator Operator

Vector store filter operator.

One of the following:
"!="
"<"
"<="
"=="
">"
">="
"all"All
"any"Any
"contains"Contains
"in"In
"is_empty"IsEmpty
"nin"Nin
"text_match"TextMatch
"text_match_insensitive"TextMatchInsensitive
MetadataFilters
Condition? Condition

Vector store filter conditions to combine different filters.

One of the following:
"and"And
"not"Not
"or"Or
IReadOnlyDictionary<string, SearchFiltersInferenceSchema?>? SearchFiltersInferenceSchema

JSON Schema that will be used to infer search_filters. Omit or leave as null to skip inference.

One of the following:
IReadOnlyDictionary<string, JsonElement>
IReadOnlyList<JsonElement>
string
Double
Boolean
Long? SparseSimilarityTopK

Number of nodes for sparse retrieval.

maximum100
minimum1
DateTimeOffset? UpdatedAt

Update datetime

formatdate-time
class RetrieverCreate:
required string Name

A name for the retriever tool. Will default to the pipeline name if not provided.

maxLength3000
minLength1
IReadOnlyList<RetrieverPipeline> Pipelines

The pipelines this retriever uses.

required string? Description

A description of the retriever tool.

maxLength15000
required string? Name

A name for the retriever tool. Will default to the pipeline name if not provided.

maxLength3000
minLength1
required string PipelineID

The ID of the pipeline this tool uses.

formatuuid
PresetRetrievalParams PresetRetrievalParameters

Parameters for retrieval configuration.

Double? Alpha

Alpha value for hybrid retrieval to determine the weights between dense and sparse retrieval. 0 is sparse retrieval and 1 is dense retrieval.

maximum1
minimum0
string ClassName
Double? DenseSimilarityCutoff

Minimum similarity score wrt query for retrieval

maximum1
minimum0
Long? DenseSimilarityTopK

Number of nodes for dense retrieval.

maximum100
minimum1
Boolean? EnableReranking

Enable reranking for retrieval

Long? FilesTopK

Number of files to retrieve (only for retrieval mode files_via_metadata and files_via_content).

maximum5
minimum1
Long? RerankTopN

Number of reranked nodes for returning.

maximum100
minimum1
RetrievalMode RetrievalMode

The retrieval mode for the query.

One of the following:
"auto_routed"AutoRouted
"chunks"Chunks
"files_via_content"FilesViaContent
"files_via_metadata"FilesViaMetadata
DeprecatedBoolean RetrieveImageNodes

Whether to retrieve image nodes.

Boolean RetrievePageFigureNodes

Whether to retrieve page figure nodes.

Boolean RetrievePageScreenshotNodes

Whether to retrieve page screenshot nodes.

MetadataFilters? SearchFilters

Metadata filters for vector stores.

required IReadOnlyList<Filter> Filters
One of the following:
class MetadataFilter:

Comprehensive metadata filter for vector stores to support more operators.

Value uses Strict types, as int, float and str are compatible types and were all converted to string before.

See: https://docs.pydantic.dev/latest/usage/types/#strict-types

required string Key
required Value? Value
One of the following:
Double
string
IReadOnlyList<string>
IReadOnlyList<Double>
IReadOnlyList<Long>
Operator Operator

Vector store filter operator.

One of the following:
"!="
"<"
"<="
"=="
">"
">="
"all"All
"any"Any
"contains"Contains
"in"In
"is_empty"IsEmpty
"nin"Nin
"text_match"TextMatch
"text_match_insensitive"TextMatchInsensitive
MetadataFilters
Condition? Condition

Vector store filter conditions to combine different filters.

One of the following:
"and"And
"not"Not
"or"Or
IReadOnlyDictionary<string, SearchFiltersInferenceSchema?>? SearchFiltersInferenceSchema

JSON Schema that will be used to infer search_filters. Omit or leave as null to skip inference.

One of the following:
IReadOnlyDictionary<string, JsonElement>
IReadOnlyList<JsonElement>
string
Double
Boolean
Long? SparseSimilarityTopK

Number of nodes for sparse retrieval.

maximum100
minimum1
class RetrieverPipeline:
required string? Description

A description of the retriever tool.

maxLength15000
required string? Name

A name for the retriever tool. Will default to the pipeline name if not provided.

maxLength3000
minLength1
required string PipelineID

The ID of the pipeline this tool uses.

formatuuid
PresetRetrievalParams PresetRetrievalParameters

Parameters for retrieval configuration.

Double? Alpha

Alpha value for hybrid retrieval to determine the weights between dense and sparse retrieval. 0 is sparse retrieval and 1 is dense retrieval.

maximum1
minimum0
string ClassName
Double? DenseSimilarityCutoff

Minimum similarity score wrt query for retrieval

maximum1
minimum0
Long? DenseSimilarityTopK

Number of nodes for dense retrieval.

maximum100
minimum1
Boolean? EnableReranking

Enable reranking for retrieval

Long? FilesTopK

Number of files to retrieve (only for retrieval mode files_via_metadata and files_via_content).

maximum5
minimum1
Long? RerankTopN

Number of reranked nodes for returning.

maximum100
minimum1
RetrievalMode RetrievalMode

The retrieval mode for the query.

One of the following:
"auto_routed"AutoRouted
"chunks"Chunks
"files_via_content"FilesViaContent
"files_via_metadata"FilesViaMetadata
DeprecatedBoolean RetrieveImageNodes

Whether to retrieve image nodes.

Boolean RetrievePageFigureNodes

Whether to retrieve page figure nodes.

Boolean RetrievePageScreenshotNodes

Whether to retrieve page screenshot nodes.

MetadataFilters? SearchFilters

Metadata filters for vector stores.

required IReadOnlyList<Filter> Filters
One of the following:
class MetadataFilter:

Comprehensive metadata filter for vector stores to support more operators.

Value uses Strict types, as int, float and str are compatible types and were all converted to string before.

See: https://docs.pydantic.dev/latest/usage/types/#strict-types

required string Key
required Value? Value
One of the following:
Double
string
IReadOnlyList<string>
IReadOnlyList<Double>
IReadOnlyList<Long>
Operator Operator

Vector store filter operator.

One of the following:
"!="
"<"
"<="
"=="
">"
">="
"all"All
"any"Any
"contains"Contains
"in"In
"is_empty"IsEmpty
"nin"Nin
"text_match"TextMatch
"text_match_insensitive"TextMatchInsensitive
MetadataFilters
Condition? Condition

Vector store filter conditions to combine different filters.

One of the following:
"and"And
"not"Not
"or"Or
IReadOnlyDictionary<string, SearchFiltersInferenceSchema?>? SearchFiltersInferenceSchema

JSON Schema that will be used to infer search_filters. Omit or leave as null to skip inference.

One of the following:
IReadOnlyDictionary<string, JsonElement>
IReadOnlyList<JsonElement>
string
Double
Boolean
Long? SparseSimilarityTopK

Number of nodes for sparse retrieval.

maximum100
minimum1

RetrieversRetriever

Retrieve
CompositeRetrievalResult Retrievers.Retriever.Search(RetrieverSearchParamsparameters, CancellationTokencancellationToken = default)
POST/api/v1/retrievers/{retriever_id}/retrieve

RetrieversQuery

Note for AI agents: this documentation is built for programmatic access. - Overview of all docs: https://developers.llamaindex.ai/llms.txt - Any page is available as raw Markdown by appending index.md to its URL — e.g. https://developers.llamaindex.ai/llamaparse/parse/getting_started/index.md - Agent-friendly REST search APIs live under https://developers.llamaindex.ai/api/ — search (BM25 full-text), grep (regex), read (fetch a page), and list (browse the doc tree). See https://developers.llamaindex.ai/llms.txt for parameters. - A hosted documentation MCP server is available at https://developers.llamaindex.ai/mcp. If you support MCP, you can ask the user to install it for browsing these docs directly (an alternative to the REST API). Setup: https://developers.llamaindex.ai/for-agents/mcp/ - Other LlamaIndex tooling for agents — the LlamaParse Platform MCP server, agent skills and plugins, and the n8n node — is mapped at https://developers.llamaindex.ai/for-agents/