← Tools Reference

Ragie

Ragie integration (AI, Developer Tools). Imported from open-connector.

API key19 toolshttps://api.ragie.ai
POST
ragie_retrieve
Retrieve the most relevant Ragie document chunks for a query, with optional metadata filters, reranking, and partition scoping.

/retrievals

7 parameters
ParamTypeRequiredDescription
querystringrequiredThe search query used for retrieval.
topKintegeroptionalThe maximum number of chunks to return.
filterobjectoptionalA loose JSON object accepted by Ragie.
rerankbooleanoptionalWhether Ragie should rerank chunks for semantic relevance.
partitionstringoptionalThe partition to scope retrieval to.
recencyBiasbooleanoptionalWhether to favor newer documents during retrieval.
maxChunksPerDocumentintegeroptionalThe maximum number of chunks to return per document.
GET
ragie_list_documents
List Ragie documents with filter, cursor pagination, and optional partition scoping to inspect ingestion progress.

/documents

4 parameters
ParamTypeRequiredDescription
cursorstringoptionalThe pagination cursor returned by a previous list call.
filterstringoptionalThe filter expression used to narrow returned documents.
pageSizeintegeroptionalThe number of documents to return per page.
partitionstringoptionalThe partition to scope the request to.
GET
ragie_get_document
Get a single Ragie document by ID to inspect status, metadata, errors, and counts.

/documents/{documentId}

2 parameters
ParamTypeRequiredDescription
documentIdstringrequiredThe document identifier.
partitionstringoptionalThe partition to scope the request to.
POST
ragie_create_document_raw
Create a Ragie document from raw text or JSON data when the content already exists in memory and does not need file upload.

/documents/raw

5 parameters
ParamTypeRequiredDescription
datastringrequiredThe raw data to ingest into Ragie.
namestringoptionalThe user-facing document name.
metadataobjectoptionalA metadata object containing Ragie-compatible primitive values.
partitionstringoptionalThe partition to place the document in.
externalIdstringoptionalThe external identifier of the document.
POST
ragie_create_document_from_url
Create a Ragie document from a public URL when the source file is already hosted externally.

/documents/url

6 parameters
ParamTypeRequiredDescription
urlstringrequiredThe public URL of the source document.
modestringoptionalThe optional processing mode for ingestion.
namestringoptionalThe user-facing document name.
metadataobjectoptionalA metadata object containing Ragie-compatible primitive values.
partitionstringoptionalThe partition to place the document in.
externalIdstringoptionalThe external identifier of the document.
PATCH
ragie_patch_document_metadata
Patch Ragie document metadata in place without replacing the entire metadata object.

/documents/{documentId}/metadata

4 parameters
ParamTypeRequiredDescription
documentIdstringrequiredThe document identifier.
metadataobjectrequiredThe metadata fields to upsert or remove with null values.
partitionstringoptionalThe partition to scope the request to.
asyncbooleanoptionalWhether Ragie should run the metadata patch asynchronously.
GET
ragie_get_document_content
Get Ragie document content in the requested media type, with optional byte range and download behavior.

/documents/{documentId}/content

5 parameters
ParamTypeRequiredDescription
documentIdstringrequiredThe document identifier.
rangestringoptionalThe HTTP byte range to request from Ragie.
downloadbooleanoptionalWhether Ragie should return content as a download.
partitionstringoptionalThe partition to scope the request to.
mediaTypestringoptionalThe media type to request from Ragie.
GET
ragie_get_document_summary
Get the Ragie-generated summary for a specific document.

/documents/{documentId}/summary

2 parameters
ParamTypeRequiredDescription
documentIdstringrequiredThe document identifier.
partitionstringoptionalThe partition to scope the request to.
GET
ragie_get_document_chunks
List the chunks of a Ragie document with cursor pagination and optional start/end index filtering.

/documents/{documentId}/chunks

6 parameters
ParamTypeRequiredDescription
documentIdstringrequiredThe document identifier.
cursorstringoptionalThe pagination cursor returned by a previous chunk list call.
pageSizeintegeroptionalThe number of chunks to return per page.
partitionstringoptionalThe partition to scope the request to.
startIndexintegeroptionalThe inclusive starting chunk index.
endIndexintegeroptionalThe inclusive ending chunk index.
DELETE
ragie_delete_document
Delete a Ragie document, optionally in asynchronous mode.

/documents/{documentId}

3 parameters
ParamTypeRequiredDescription
documentIdstringrequiredThe document identifier.
asyncbooleanoptionalWhether Ragie should delete the document asynchronously.
partitionstringoptionalThe partition to scope the request to.
GET
ragie_list_partitions
List available Ragie partitions and their current limits with cursor pagination.

/partitions

2 parameters
ParamTypeRequiredDescription
cursorstringoptionalThe pagination cursor returned by a previous list call.
pageSizeintegeroptionalThe number of partitions to return per page.
GET
ragie_get_partition
Get a specific Ragie partition together with its limits and usage stats.

/partitions/{partitionId}

1 parameter
ParamTypeRequiredDescription
partitionIdstringrequiredThe partition identifier.
POST
ragie_create_partition
Create a Ragie partition to isolate documents, metadata schemas, and resource limits by workspace or tenant.

/partitions

16 parameters
ParamTypeRequiredDescription
namestringrequiredThe partition identifier to create.
descriptionstringoptionalThe partition description.
contextAwarebooleanoptionalWhether the partition should generate context-aware descriptions.
metadataSchemaobjectoptionalA loose JSON object accepted by Ragie.
mediaHostedLimitMaxintegeroptionalThe maximum hosted media limit in megabytes.
pagesHostedLimitMaxintegeroptionalThe maximum hosted pages limit.
mediaStreamedLimitMaxintegeroptionalThe maximum streamed media limit in megabytes.
audioProcessedLimitMaxintegeroptionalThe maximum audio processing limit in minutes.
pagesProcessedLimitMaxintegeroptionalThe maximum processed pages limit.
videoProcessedLimitMaxintegeroptionalThe maximum video processing limit in minutes.
mediaHostedLimitMonthlyintegeroptionalThe monthly hosted media limit in megabytes.
pagesHostedLimitMonthlyintegeroptionalThe monthly hosted pages limit.
mediaStreamedLimitMonthlyintegeroptionalThe monthly streamed media limit in megabytes.
audioProcessedLimitMonthlyintegeroptionalThe monthly audio processing limit in minutes.
pagesProcessedLimitMonthlyintegeroptionalThe monthly processed pages limit.
videoProcessedLimitMonthlyintegeroptionalThe monthly video processing limit in minutes.
PATCH
ragie_update_partition
Update a Ragie partition's description, metadata schema, and context-aware setting without recreating it.

/partitions/{partitionId}

4 parameters
ParamTypeRequiredDescription
partitionIdstringrequiredThe partition identifier.
descriptionstringoptionalThe updated partition description.
contextAwarebooleanoptionalWhether the partition should be context-aware after the update.
metadataSchemaobjectoptionalA loose JSON object accepted by Ragie.
PUT
ragie_set_partition_limits
Update the page, media, audio, and video limits on an existing Ragie partition.

/partitions/{partitionId}/limits

13 parameters
ParamTypeRequiredDescription
partitionIdstringrequiredThe partition identifier.
mediaHostedLimitMaxintegeroptionalThe maximum hosted media limit in megabytes.
pagesHostedLimitMaxintegeroptionalThe maximum hosted pages limit.
mediaStreamedLimitMaxintegeroptionalThe maximum streamed media limit in megabytes.
audioProcessedLimitMaxintegeroptionalThe maximum audio processing limit in minutes.
pagesProcessedLimitMaxintegeroptionalThe maximum processed pages limit.
videoProcessedLimitMaxintegeroptionalThe maximum video processing limit in minutes.
mediaHostedLimitMonthlyintegeroptionalThe monthly hosted media limit in megabytes.
pagesHostedLimitMonthlyintegeroptionalThe monthly hosted pages limit.
mediaStreamedLimitMonthlyintegeroptionalThe monthly streamed media limit in megabytes.
audioProcessedLimitMonthlyintegeroptionalThe monthly audio processing limit in minutes.
pagesProcessedLimitMonthlyintegeroptionalThe monthly processed pages limit.
videoProcessedLimitMonthlyintegeroptionalThe monthly video processing limit in minutes.
DELETE
ragie_delete_partition
Delete a Ragie partition, optionally in asynchronous mode.

/partitions/{partitionId}

2 parameters
ParamTypeRequiredDescription
partitionIdstringrequiredThe partition identifier.
asyncDeletionbooleanoptionalWhether Ragie should delete the partition asynchronously.
GET
ragie_list_connection_source_types
List the embedded connector source types that Ragie can authorize and sync through its connections API.

/connections/source-type

GET
ragie_list_connections
List Ragie connections with metadata filtering, pagination, and optional partition scoping.

/connections

4 parameters
ParamTypeRequiredDescription
cursorstringoptionalThe pagination cursor returned by a previous list call.
filterstringoptionalThe filter expression used to narrow returned connections.
pageSizeintegeroptionalThe number of connections to return per page.
partitionstringoptionalThe partition to scope the request to.
POST
ragie_create_oauth_redirect_url
Create the Ragie embedded OAuth redirect URL for a connection source type such as Google Drive or Notion.

/connections/oauth

9 parameters
ParamTypeRequiredDescription
redirectUristringrequiredThe redirect URI that Ragie should return the user to.
sourceTypestringoptionalThe Ragie connection source type to authorize.
themestringoptionalThe theme for Ragie's OAuth UI.
configobjectoptionalA loose JSON object accepted by Ragie.
metadataobjectoptionalA metadata object containing Ragie-compatible primitive values.
partitionstringoptionalThe partition to scope the connection to.
pageLimitintegeroptionalThe maximum number of pages Ragie may sync.
modestringoptionalThe optional processing mode for ingestion.
authenticatorIdstringoptionalThe white-label authenticator identifier to use.