API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Shared

ModelsExpand Collapse

type CloudAstraDBVectorStore struct{…}

Cloud AstraDB Vector Store.

This class is used to store the configuration for an AstraDB vector store, so that it can be created and used in LlamaCloud.

Args: token (str): The Astra DB Application Token to use. api_endpoint (str): The Astra DB JSON API endpoint for your database. collection_name (str): Collection name to use. If not existing, it will be created. embedding_dimension (int): Length of the embedding vectors in use. keyspace (optional[str]): The keyspace to use. If not provided, ‘default_keyspace’

Token string

The Astra DB Application Token to use

formatpassword

APIEndpoint string

The Astra DB JSON API endpoint for your database

CollectionName string

Collection name to use. If not existing, it will be created

EmbeddingDimension int64

Length of the embedding vectors in use

ClassName stringoptional

Keyspace stringoptional

The keyspace to use. If not provided, ‘default_keyspace’

SupportsNestedMetadataFilters booloptional

type CloudAzStorageBlobDataSource struct{…}

AccountURL string

The Azure Storage Blob account URL to use for authentication.

ContainerName string

The name of the Azure Storage Blob container to read from.

AccountKey stringoptional

The Azure Storage Blob account key to use for authentication.

formatpassword

AccountName stringoptional

The Azure Storage Blob account name to use for authentication.

Blob stringoptional

The blob name to read from.

ClassName stringoptional

ClientID stringoptional

The Azure AD client ID to use for authentication.

ClientSecret stringoptional

The Azure AD client secret to use for authentication.

formatpassword

Prefix stringoptional

The prefix of the Azure Storage Blob objects to read from.

SupportsAccessControl booloptional

TenantID stringoptional

The Azure AD tenant ID to use for authentication.

type CloudAzureAISearchVectorStore struct{…}

Cloud Azure AI Search Vector Store.

SearchServiceAPIKey string

SearchServiceEndpoint string

ClassName stringoptional

ClientID stringoptional

ClientSecret stringoptional

EmbeddingDimension int64optional

FilterableMetadataFieldKeys map[string, any]optional

IndexName stringoptional

SearchServiceAPIVersion stringoptional

SupportsNestedMetadataFilters booloptional

TenantID stringoptional

type CloudBoxDataSource struct{…}

AuthenticationMechanism CloudBoxDataSourceAuthenticationMechanism

The type of authentication to use (Developer Token or CCG)

One of the following:

const CloudBoxDataSourceAuthenticationMechanismDeveloperToken CloudBoxDataSourceAuthenticationMechanism = "developer_token"

const CloudBoxDataSourceAuthenticationMechanismCcg CloudBoxDataSourceAuthenticationMechanism = "ccg"

ClassName stringoptional

ClientID stringoptional

Box API key used for identifying the application the user is authenticating with

ClientSecret stringoptional

Box API secret used for making auth requests.

formatpassword

DeveloperToken stringoptional

Developer token for authentication if authentication_mechanism is ‘developer_token’.

formatpassword

EnterpriseID stringoptional

Box Enterprise ID, if provided authenticates as service.

FolderID stringoptional

The ID of the Box folder to read from.

SupportsAccessControl booloptional

UserID stringoptional

Box User ID, if provided authenticates as user.

type CloudConfluenceDataSource struct{…}

AuthenticationMechanism string

Type of Authentication for connecting to Confluence APIs.

ServerURL string

The server URL of the Confluence instance.

APIToken stringoptional

The API token to use for authentication.

formatpassword

ClassName stringoptional

Cql stringoptional

The CQL query to use for fetching pages.

FailureHandling FailureHandlingConfigoptional

Configuration for handling failures during processing. Key-value object controlling failure handling behaviors.

Example: { “skip_list_failures”: true }

Currently supports:

• skip_list_failures: Skip failed batches/lists and continue processing

SkipListFailures booloptional

Whether to skip failed batches/lists and continue processing

IndexRestrictedPages booloptional

Whether to index restricted pages.

KeepMarkdownFormat booloptional

Whether to keep the markdown format.

Label stringoptional

The label to use for fetching pages.

PageIDs stringoptional

The page IDs of the Confluence to read from.

SpaceKey stringoptional

The space key to read from.

SupportsAccessControl booloptional

UserName stringoptional

The username to use for authentication.

type CloudGoogleDriveDataSource struct{…}

FolderID string

The ID of the Google Drive folder to read from.

ClassName stringoptional

ServiceAccountKey map[string, string]optional

A dictionary containing secret values

SupportsAccessControl booloptional

type CloudJiraDataSource struct{…}

Cloud Jira Data Source integrating JiraReader.

AuthenticationMechanism string

Type of Authentication for connecting to Jira APIs.

Query string

JQL (Jira Query Language) query to search.

APIToken stringoptional

The API/ Access Token used for Basic, PAT and OAuth2 authentication.

formatpassword

ClassName stringoptional

CloudID stringoptional

The cloud ID, used in case of OAuth2.

Email stringoptional

The email address to use for authentication.

ServerURL stringoptional

The server url for Jira Cloud.

SupportsAccessControl booloptional

type CloudJiraDataSourceV2 struct{…}

Cloud Jira Data Source integrating JiraReaderV2.

AuthenticationMechanism string

Type of Authentication for connecting to Jira APIs.

Query string

JQL (Jira Query Language) query to search.

ServerURL string

The server url for Jira Cloud.

APIToken stringoptional

The API Access Token used for Basic, PAT and OAuth2 authentication.

formatpassword

APIVersion CloudJiraDataSourceV2APIVersionoptional

Jira REST API version to use (2 or 3). 3 supports Atlassian Document Format (ADF).

One of the following:

const CloudJiraDataSourceV2APIVersion2 CloudJiraDataSourceV2APIVersion = "2"

const CloudJiraDataSourceV2APIVersion3 CloudJiraDataSourceV2APIVersion = "3"

ClassName stringoptional

CloudID stringoptional

The cloud ID, used in case of OAuth2.

Email stringoptional

The email address to use for authentication.

Expand stringoptional

Fields to expand in the response.

Fields []stringoptional

List of fields to retrieve from Jira. If None, retrieves all fields.

GetPermissions booloptional

Whether to fetch project role permissions and issue-level security

RequestsPerMinute int64optional

Rate limit for Jira API requests per minute.

SupportsAccessControl booloptional

type CloudMilvusVectorStore struct{…}

Cloud Milvus Vector Store.

Uri string

Token stringoptional

ClassName stringoptional

CollectionName stringoptional

EmbeddingDimension int64optional

SupportsNestedMetadataFilters booloptional

type CloudMongoDBAtlasVectorSearch struct{…}

Cloud MongoDB Atlas Vector Store.

This class is used to store the configuration for a MongoDB Atlas vector store, so that it can be created and used in LlamaCloud.

Args: mongodb_uri (str): URI for connecting to MongoDB Atlas db_name (str): name of the MongoDB database collection_name (str): name of the MongoDB collection vector_index_name (str): name of the MongoDB Atlas vector index fulltext_index_name (str): name of the MongoDB Atlas full-text index

CollectionName string

DBName string

MongoDBUri string

ClassName stringoptional

EmbeddingDimension int64optional

FulltextIndexName stringoptional

SupportsNestedMetadataFilters booloptional

VectorIndexName stringoptional

type CloudNotionPageDataSource struct{…}

IntegrationToken string

The integration token to use for authentication.

formatpassword

ClassName stringoptional

DatabaseIDs stringoptional

The Notion Database Id to read content from.

PageIDs stringoptional

The Page ID’s of the Notion to read from.

SupportsAccessControl booloptional

type CloudOneDriveDataSource struct{…}

ClientID string

The client ID to use for authentication.

ClientSecret string

The client secret to use for authentication.

formatpassword

TenantID string

The tenant ID to use for authentication.

UserPrincipalName string

The user principal name to use for authentication.

ClassName stringoptional

FolderID stringoptional

The ID of the OneDrive folder to read from.

FolderPath stringoptional

The path of the OneDrive folder to read from.

RequiredExts []stringoptional

The list of required file extensions.

SupportsAccessControl booloptional

type CloudPineconeVectorStore struct{…}

Cloud Pinecone Vector Store.

This class is used to store the configuration for a Pinecone vector store, so that it can be created and used in LlamaCloud.

Args: api_key (str): API key for authenticating with Pinecone index_name (str): name of the Pinecone index namespace (optional[str]): namespace to use in the Pinecone index insert_kwargs (optional[dict]): additional kwargs to pass during insertion

APIKey string

The API key for authenticating with Pinecone

formatpassword

IndexName string

ClassName stringoptional

InsertKwargs map[string, any]optional

Namespace stringoptional

SupportsNestedMetadataFilters booloptional

type CloudPostgresVectorStore struct{…}

Database string

EmbedDim int64

Host string

Password string

Port int64

SchemaName string

TableName string

User string

ClassName stringoptional

HnswSettings PgVectorHnswSettingsoptional

HNSW settings for PGVector.

DistanceMethod PgVectorHnswSettingsDistanceMethodoptional

The distance method to use.

One of the following:

const PgVectorHnswSettingsDistanceMethodL2 PgVectorHnswSettingsDistanceMethod = "l2"

const PgVectorHnswSettingsDistanceMethodIP PgVectorHnswSettingsDistanceMethod = "ip"

const PgVectorHnswSettingsDistanceMethodCosine PgVectorHnswSettingsDistanceMethod = "cosine"

const PgVectorHnswSettingsDistanceMethodL1 PgVectorHnswSettingsDistanceMethod = "l1"

const PgVectorHnswSettingsDistanceMethodHamming PgVectorHnswSettingsDistanceMethod = "hamming"

const PgVectorHnswSettingsDistanceMethodJaccard PgVectorHnswSettingsDistanceMethod = "jaccard"

EfConstruction int64optional

The number of edges to use during the construction phase.

minimum1

EfSearch int64optional

The number of edges to use during the search phase.

minimum1

M int64optional

The number of bi-directional links created for each new element.

minimum1

VectorType PgVectorHnswSettingsVectorTypeoptional

The type of vector to use.

One of the following:

const PgVectorHnswSettingsVectorTypeVector PgVectorHnswSettingsVectorType = "vector"

const PgVectorHnswSettingsVectorTypeHalfVec PgVectorHnswSettingsVectorType = "half_vec"

const PgVectorHnswSettingsVectorTypeBit PgVectorHnswSettingsVectorType = "bit"

const PgVectorHnswSettingsVectorTypeSparseVec PgVectorHnswSettingsVectorType = "sparse_vec"

HybridSearch booloptional

PerformSetup booloptional

SupportsNestedMetadataFilters booloptional

type CloudQdrantVectorStore struct{…}

Cloud Qdrant Vector Store.

This class is used to store the configuration for a Qdrant vector store, so that it can be created and used in LlamaCloud.

Args: collection_name (str): name of the Qdrant collection url (str): url of the Qdrant instance api_key (str): API key for authenticating with Qdrant max_retries (int): maximum number of retries in case of a failure. Defaults to 3 client_kwargs (dict): additional kwargs to pass to the Qdrant client

APIKey string

CollectionName string

URL string

ClassName stringoptional

ClientKwargs map[string, any]optional

MaxRetries int64optional

SupportsNestedMetadataFilters booloptional

type CloudS3DataSource struct{…}

Bucket string

The name of the S3 bucket to read from.

AwsAccessID stringoptional

The AWS access ID to use for authentication.

AwsAccessSecret stringoptional

The AWS access secret to use for authentication.

formatpassword

ClassName stringoptional

Prefix stringoptional

The prefix of the S3 objects to read from.

RegexPattern stringoptional

The regex pattern to filter S3 objects. Must be a valid regex pattern.

S3EndpointURL stringoptional

The S3 endpoint URL to use for authentication.

SupportsAccessControl booloptional

type CloudSharepointDataSource struct{…}

ClientID string

The client ID to use for authentication.

ClientSecret string

The client secret to use for authentication.

formatpassword

TenantID string

The tenant ID to use for authentication.

ClassName stringoptional

DriveName stringoptional

The name of the Sharepoint drive to read from.

ExcludePathPatterns []stringoptional

List of regex patterns for file paths to exclude. Files whose paths (including filename) match any pattern will be excluded. Example: [‘/temp/’, ‘/backup/’, ‘.git/’, ‘.tmp$’, ’^~’]

FolderID stringoptional

The ID of the Sharepoint folder to read from.

FolderPath stringoptional

The path of the Sharepoint folder to read from.

GetPermissions booloptional

Whether to get permissions for the sharepoint site.

IncludePathPatterns []stringoptional

List of regex patterns for file paths to include. Full paths (including filename) must match at least one pattern to be included. Example: [‘/reports/’, ‘/docs/..pdf$’, ‘^Report..pdf$’]

RequiredExts []stringoptional

The list of required file extensions.

SiteID stringoptional

The ID of the SharePoint site to download from.

SiteName stringoptional

The name of the SharePoint site to download from.

SupportsAccessControl booloptional

type CloudSlackDataSource struct{…}

SlackToken string

Slack Bot Token.

formatpassword

ChannelIDs stringoptional

Slack Channel.

ChannelPatterns stringoptional

Slack Channel name pattern.

ClassName stringoptional

EarliestDate stringoptional

Earliest date.

EarliestDateTimestamp float64optional

Earliest date timestamp.

LatestDate stringoptional

Latest date.

LatestDateTimestamp float64optional

Latest date timestamp.

SupportsAccessControl booloptional

type FailureHandlingConfig struct{…}

Configuration for handling different types of failures during data source processing.

SkipListFailures booloptional

Whether to skip failed batches/lists and continue processing

type PgVectorHnswSettings struct{…}

HNSW settings for PGVector.

DistanceMethod PgVectorHnswSettingsDistanceMethodoptional

The distance method to use.

One of the following:

const PgVectorHnswSettingsDistanceMethodL2 PgVectorHnswSettingsDistanceMethod = "l2"

const PgVectorHnswSettingsDistanceMethodIP PgVectorHnswSettingsDistanceMethod = "ip"

const PgVectorHnswSettingsDistanceMethodCosine PgVectorHnswSettingsDistanceMethod = "cosine"

const PgVectorHnswSettingsDistanceMethodL1 PgVectorHnswSettingsDistanceMethod = "l1"

const PgVectorHnswSettingsDistanceMethodHamming PgVectorHnswSettingsDistanceMethod = "hamming"

const PgVectorHnswSettingsDistanceMethodJaccard PgVectorHnswSettingsDistanceMethod = "jaccard"

EfConstruction int64optional

The number of edges to use during the construction phase.

minimum1

EfSearch int64optional

The number of edges to use during the search phase.

minimum1

M int64optional

The number of bi-directional links created for each new element.

minimum1

VectorType PgVectorHnswSettingsVectorTypeoptional

The type of vector to use.

One of the following:

const PgVectorHnswSettingsVectorTypeVector PgVectorHnswSettingsVectorType = "vector"

const PgVectorHnswSettingsVectorTypeHalfVec PgVectorHnswSettingsVectorType = "half_vec"

const PgVectorHnswSettingsVectorTypeBit PgVectorHnswSettingsVectorType = "bit"

const PgVectorHnswSettingsVectorTypeSparseVec PgVectorHnswSettingsVectorType = "sparse_vec"