The Ragie connector lets your AI agent act in each user's Ragie account. Each user connects their own Ragie access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 32 tools.
- Tools
- 32
- What they doRead · write · destructive
- 18 · 11 · 318 read11 write3 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Ragie connection
In AgentKit > Connections, create a Ragie connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'ragie'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Ragie:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'ragie_connection_source_types_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "ragie"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Ragie:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="ragie_connection_source_types_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Ragie credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolragie_connection_getFetch one connection by id.Read-onlyGet Connection
Fetch one connection by id. Returns id, name, type, source, enabled flag, disabled_by_system reason, page_limit, sync_filter, last_synced_at, syncing flag and partition. Use ragie_connection_get for one connection's settings. Use ragie_connection_stats_get for document and page counts. Requires a connection id from ragie_connections_list.
Inputs
connection_idstringrequired- ID of the connection. Get it from ragie_connections_list.
ragie_connection_source_types_listList the data-source types Ragie can connect to.Read-onlyList Connection Source Types
List the data-source types Ragie can connect to. Returns a list of source types, each with source_type, display_name, icon_url and docs_url. Use ragie_connection_source_types_list to see which integrations are supported. Use ragie_connections_list for connections you already have.
Inputs
This tool takes no inputs.
ragie_connection_stats_getFetch document and page counts for a connection.Read-onlyGet Connection Stats
Fetch document and page counts for a connection. Returns document_count and page_count. Use ragie_connection_stats_get to see how much content a connection has synced. Use ragie_connection_get for its settings. Requires a connection id from ragie_connections_list.
Inputs
connection_idstringrequired- ID of the connection. Get it from ragie_connections_list.
ragie_connections_listList the data-source connections (such as Google Drive, Notion or Slack) in your Ragie account.Read-onlyList Connections
List the data-source connections (such as Google Drive, Notion or Slack) in your Ragie account. Returns connections with id, name, type, source, enabled flag, last_synced_at, syncing flag and partition, plus a pagination object. Use ragie_connections_list to find a connection id. Use ragie_connection_get for one connection's details.
Inputs
cursorstring- Opaque pagination cursor. Pass the next_cursor value from the previous response to fetch the next page; omit for the first page.
filterstring- Metadata filter as a JSON string, matched against connection metadata. Example: {"team": {"$eq": "sales"}}.
page_sizeinteger- Number of items per page, from 1 to 100. Defaults to 10.default
10 partitionstring- Partition to scope the request to. If omitted, the request is scoped to the default partition.
ragie_document_chunk_getFetch a single chunk of a document by chunk id.Read-onlyGet Document Chunk
Fetch a single chunk of a document by chunk id. Returns the chunk id, index, text, metadata, links and any modality data such as word-level timestamps for audio. Use ragie_document_chunk_get when you have a chunk id from ragie_retrieve. Use ragie_document_chunks_list to page through all chunks. Requires both a document id and a chunk id.
Inputs
chunk_idstringrequired- ID of the chunk. Get it from ragie_retrieve or ragie_document_chunks_list.
document_idstringrequired- ID of the document. Get it from ragie_documents_list or from the response of a create tool.
partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
ragie_document_chunks_listList the chunks of one document, optionally limited to a range of chunk indexes.Read-onlyList Document Chunks
List the chunks of one document, optionally limited to a range of chunk indexes. Returns chunks with id, index, text, metadata and links, plus a pagination object with next_cursor and total_count. Use ragie_document_chunks_list to read a known document's content in order. Use ragie_retrieve to search across all documents. Requires a document id; the document must be at least indexed.
Inputs
document_idstringrequired- ID of the document. Get it from ragie_documents_list or from the response of a create tool.
cursorstring- Opaque pagination cursor. Pass the next_cursor value from the previous response to fetch the next page; omit for the first page.
end_indexinteger- Inclusive index of the last chunk to list. If only start_index is given, at most one chunk (matching start_index) is returned. Omit both to list all chunks.
page_sizeinteger- Number of items per page, from 1 to 100. Defaults to 10.default
10 partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
start_indexinteger- Inclusive index of the first chunk to list. If only end_index is given, at most one chunk (matching end_index) is returned. Omit both to list all chunks.
ragie_document_getFetch one document by id.Read-onlyGet Document
Fetch one document by id. Returns the document id, name, status, metadata, partition, errors, chunk_count, external_id, page_count and created and updated timestamps. Use ragie_document_get to check a document's processing status. Use ragie_document_summary_get for its summary. Requires a document id from ragie_documents_list or a create tool.
Inputs
document_idstringrequired- ID of the document. Get it from ragie_documents_list or from the response of a create tool.
partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
ragie_document_summary_getFetch the generated summary of a document.Read-onlyGet Document Summary
Fetch the generated summary of a document. Returns document_id and summary text. Use ragie_document_summary_get for a quick overview. Use ragie_document_chunks_list for the full content. The summary is available only once the document status is summary_indexed or ready.
Inputs
document_idstringrequired- ID of the document. Get it from ragie_documents_list or from the response of a create tool.
partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
ragie_documents_listList documents in your Ragie account, optionally filtered by metadata.Read-onlyList Documents
List documents in your Ragie account, optionally filtered by metadata. Returns documents with id, name, status, metadata, partition, chunk_count, external_id and page_count, plus a pagination object with next_cursor and total_count. Use ragie_documents_list to browse or find a document id. Use ragie_retrieve to search document content.
Inputs
cursorstring- Opaque pagination cursor. Pass the next_cursor value from the previous response to fetch the next page; omit for the first page.
filterstring- Metadata filter as a JSON string. Supports $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, combinable with $and and $or. Example: {"department": {"$eq": "legal"}}.
page_sizeinteger- Number of items per page, from 1 to 100. Defaults to 10.default
10 partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
ragie_element_getFetch a single extracted document element by id.Read-onlyGet Document Element
Fetch a single extracted document element by id. Returns the element id, index, type, text, markdown, structured data, metadata, location and created_at. Use ragie_element_get when you have an element id from ragie_elements_list. Requires an element id.
Inputs
element_idstringrequired- ID of the element. Get it from ragie_elements_list.
ragie_elements_listList the structured elements (titles, paragraphs, tables, figures and so on) Ragie extracted from a document.Read-onlyList Document Elements
List the structured elements (titles, paragraphs, tables, figures and so on) Ragie extracted from a document. Returns document_elements, each with id, index, type, text, markdown, data and location, plus a pagination object with next_cursor and total_count. Use ragie_elements_list to inspect document structure. Use ragie_document_chunks_list for retrieval-ready text chunks. Requires a document id.
Inputs
document_idstringrequired- ID of the document. Get it from ragie_documents_list or from the response of a create tool.
cursorstring- Opaque pagination cursor. Pass the next_cursor value from the previous response to fetch the next page; omit for the first page.
index_endinteger- Only return elements at or before this element index.
index_startinteger- Only return elements at or after this element index.
page_sizeinteger- Number of items per page, from 1 to 100. Defaults to 10.default
10 partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
typearray- Only return elements of these types. Repeat values as a list. Example: ["Table", "Title"].
ragie_entities_list_by_documentList entities extracted from one document by your instructions.Read-onlyList Entities By Document
List entities extracted from one document by your instructions. Returns entities with id, instruction_id, document_id, chunk_id, data and timestamps, plus a pagination object. Use ragie_entities_list_by_document to see everything extracted from a document. Use ragie_entities_list_by_instruction to see one instruction's results across documents. Requires a document id.
Inputs
document_idstringrequired- ID of the document. Get it from ragie_documents_list or from the response of a create tool.
cursorstring- Opaque pagination cursor. Pass the next_cursor value from the previous response to fetch the next page; omit for the first page.
page_sizeinteger- Number of items per page, from 1 to 100. Defaults to 10.default
10 partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
ragie_entities_list_by_instructionList entities produced by one instruction across your documents.Read-onlyList Entities By Instruction
List entities produced by one instruction across your documents. Returns entities with id, instruction_id, document_id, chunk_id, data and timestamps, plus a pagination object. Use ragie_entities_list_by_instruction to review one instruction's results. Use ragie_entities_list_by_document to see everything extracted from one document. Requires an instruction id from ragie_instructions_list.
Inputs
instruction_idstringrequired- ID of the instruction. Get it from ragie_instructions_list.
cursorstring- Opaque pagination cursor. Pass the next_cursor value from the previous response to fetch the next page; omit for the first page.
page_sizeinteger- Number of items per page, from 1 to 100. Defaults to 10.default
10 partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
ragie_instruction_extraction_logs_listList extraction log entries for an instruction, optionally filtered by document, status or time range.Read-onlyList Instruction Extraction Logs
List extraction log entries for an instruction, optionally filtered by document, status or time range. Returns log entries with their status (extracted, not_found or error) and timestamps, plus a pagination object. Use ragie_instruction_extraction_logs_list to debug why an instruction did or did not extract data. Use ragie_entities_list_by_instruction for the extracted data itself. Requires an instruction id from ragie_instructions_list.
Inputs
instruction_idstringrequired- ID of the instruction. Get it from ragie_instructions_list.
created_afterstring- Only include logs created at or after this ISO 8601 timestamp.
created_beforestring- Only include logs created before this ISO 8601 timestamp.
cursorstring- Opaque pagination cursor. Pass the next_cursor value from the previous response to fetch the next page; omit for the first page.
document_idsarray- Only return logs for these document ids.
page_sizeinteger- Number of items per page, from 1 to 100. Defaults to 10.default
10 partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
statusstring- Only return logs with this extraction status.one of
extractednot_founderror
ragie_instructions_listList all entity-extraction instructions in your account.Read-onlyList Instructions
List all entity-extraction instructions in your account. Returns instructions with id, name, prompt, entity_schema, scope, active flag, filter, partition and timestamps. Use ragie_instructions_list to find an instruction id before updating, deleting or reading its entities.
Inputs
This tool takes no inputs.
ragie_partition_getFetch one partition with its settings, limits and usage stats.Read-onlyGet Partition
Fetch one partition with its settings, limits and usage stats. Returns name, is_default, description, context_aware, metadata_schema, limits and stats. Use ragie_partition_get for details on one partition. Use ragie_partitions_list to see them all. Requires a partition name from ragie_partitions_list.
Inputs
partition_idstringrequired- Name of the partition (its identifier). Get it from ragie_partitions_list.
ragie_partitions_listList the partitions in your Ragie account.Read-onlyList Partitions
List the partitions in your Ragie account. Returns partitions with name, is_default, description, context_aware, metadata_schema and usage limits, plus a pagination object. Use ragie_partitions_list to find partition names to scope other tools. Use ragie_partition_get for usage stats on one partition.
Inputs
cursorstring- Opaque pagination cursor. Pass the next_cursor value from the previous response to fetch the next page; omit for the first page.
page_sizeinteger- Number of items per page, from 1 to 100. Defaults to 10.default
10
ragie_retrieveSearch indexed documents with a natural-language query and return the most relevant chunks.Read-onlyRetrieve Chunks
Search indexed documents with a natural-language query and return the most relevant chunks. Returns scored_chunks, each with chunk id, index, text, relevance score, document_id, document_name, document metadata and links. Use ragie_retrieve to answer questions from your content. Use ragie_documents_list to browse documents and ragie_document_chunks_list to read the chunks of one known document. Documents must be in indexed or ready status to be retrievable.
Inputs
querystringrequired- Natural-language query to search with. Example: What is our parental leave policy?
filterobject- Metadata filter limiting which documents are searched. Supports $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, combinable with $and and $or. Example: {"department": {"$eq": "legal"}}.
max_chunks_per_documentinteger- Maximum chunks to return from any single document, used to draw results from more documents. Beta feature.
partitionstring- Partition to scope the retrieval to. Omit to search the default partition, which includes documents not created in a named partition.
recency_biasboolean- Favor more recent documents over older ones in the ranking. Defaults to false.default
false rerankboolean- Rerank chunks for semantic relevance after the similarity search. Slower, but returns a smaller set of highly relevant chunks and helps reduce hallucinations. Defaults to false.default
false top_kinteger- Maximum number of chunks to return. Defaults to 8.default
8
ragie_connection_enabled_setEnable or disable a connection.WriteEnable Or Disable Connection
Enable or disable a connection. A disabled connection stops syncing. Returns the updated connection. Use ragie_connection_enabled_set to pause or resume syncing. Use ragie_connection_sync to run a sync now. Requires a connection id from ragie_connections_list.
- Idempotent
Inputs
connection_idstringrequired- ID of the connection. Get it from ragie_connections_list.
enabledbooleanrequired- True to enable the connection, false to disable it.
reasonstring- Optional reason for disabling the connection, recorded by Ragie.
ragie_connection_syncStart a sync of a connection so new and changed source content is ingested.WriteSync Connection
Start a sync of a connection so new and changed source content is ingested. Returns a message field confirming the sync was started. Use ragie_connection_sync to refresh a connection on demand. Check progress with ragie_connection_get and its syncing flag. Requires a connection id from ragie_connections_list.
Inputs
connection_idstringrequired- ID of the connection. Get it from ragie_connections_list.
ragie_document_create_from_urlIngest a document from a publicly accessible HTTP or HTTPS URL.WriteCreate Document From URL
Ingest a document from a publicly accessible HTTP or HTTPS URL. Returns the new document with its id, name, status (starts as pending), metadata, partition and external_id. Use ragie_document_create_from_url for files hosted online. Use ragie_document_create_raw for text or JSON you already have in hand. Processing is asynchronous: poll ragie_document_get until status is ready. PDFs over 2000 pages and other static files over 10000 pages are not supported.
Inputs
urlstringrequired- Public HTTP or HTTPS URL of the file to download. Example: https://example.com/handbook.pdf
external_idstring- Optional identifier for the document in your own system, such as a database id or the source URL.
metadataobject- Key-value metadata to store on the document, as an object. Keys are strings. Values may be strings, numbers, booleans, or lists of strings; up to 1000 total values (each list item counts). Reserved keys that cannot be used: document_id, document_type, document_source, document_name, document_uploaded_at, start_time, end_time, chunk_content_type. Example: {"department": "legal", "year": 2024, "tags": ["nda", "vendor"]}.
modestring- Processing strategy for textual documents: fast extracts text only and can be up to 20x faster; hi_res also extracts images and tables from Word documents, PDFs, images and PowerPoints; all processes every media type at the highest quality; agentic_ocr uses vision models (early access, contact Ragie support to enable). Omit to use the account default.one of
fasthi_resallagentic_ocr namestring- Name for the document. If omitted, Ragie names it with the current timestamp.
partitionstring- Partition to create the document in. Partitions are created automatically the first time a document is added. Must be lowercase alphanumeric and may include _ and -.
ragie_document_create_rawIngest a document from raw text or a JSON object.WriteCreate Document From Text
Ingest a document from raw text or a JSON object. Returns the new document with its id, name, status (starts as pending), metadata, partition and external_id. Use ragie_document_create_raw when you already hold the content. Use ragie_document_create_from_url for files hosted online. Processing is asynchronous: poll ragie_document_get until status is ready.
Inputs
datastringrequired- Document content as plain text, or as a JSON object. Example: "Refunds are accepted within 30 days of purchase."
external_idstring- Optional identifier for the document in your own system, such as a database id or the source URL.
metadataobject- Key-value metadata to store on the document, as an object. Keys are strings. Values may be strings, numbers, booleans, or lists of strings; up to 1000 total values (each list item counts). Reserved keys that cannot be used: document_id, document_type, document_source, document_name, document_uploaded_at, start_time, end_time, chunk_content_type. Example: {"department": "legal", "year": 2024, "tags": ["nda", "vendor"]}.
namestring- Name for the document. If omitted, Ragie names it with the current timestamp.
partitionstring- Partition to create the document in. Partitions are created automatically the first time a document is added. Must be lowercase alphanumeric and may include _ and -.
ragie_document_metadata_updateMerge changes into a document's metadata without reprocessing the document.WriteUpdate Document Metadata
Merge changes into a document's metadata without reprocessing the document. Returns the full metadata of the document including the update, or a status field when async is true. Use ragie_document_metadata_update to add, change or remove metadata keys. A key set to null is deleted. Requires a document id from ragie_documents_list.
- Idempotent
Inputs
document_idstringrequired- ID of the document. Get it from ragie_documents_list or from the response of a create tool.
metadataobjectrequired- Partial metadata update, as an object. Keys are strings; values may be strings, numbers, booleans, or lists of strings. A key set to null is removed. Up to 1000 total values including existing metadata. For documents managed by a connection, the change is stored as an overlay re-applied on every sync. Example: {"status": "reviewed", "draft": null}.
asyncboolean- Run the update in the background. If true, the request returns immediately with HTTP 202; if false, it completes before returning. Defaults to false.
partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
ragie_document_update_from_urlReplace a document's file with a new file downloaded from a public URL and reprocess it.WriteUpdate Document From URL
Replace a document's file with a new file downloaded from a public URL and reprocess it. Returns a status field for the update. Use ragie_document_update_from_url to refresh a document that came from a URL. Use ragie_document_update_raw to replace it with text. Requires a document id from ragie_documents_list. Processing is asynchronous: poll ragie_document_get until status is ready.
- Idempotent
Inputs
document_idstringrequired- ID of the document. Get it from ragie_documents_list or from the response of a create tool.
urlstringrequired- Public HTTP or HTTPS URL of the replacement file. Example: https://example.com/handbook-v2.pdf
modestring- Processing strategy for textual documents: fast extracts text only and can be up to 20x faster; hi_res also extracts images and tables from Word documents, PDFs, images and PowerPoints; all processes every media type at the highest quality; agentic_ocr uses vision models (early access, contact Ragie support to enable). Omit to use the account default.one of
fasthi_resallagentic_ocr partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
ragie_document_update_rawReplace a document's content with new raw text or a JSON object and reprocess it.WriteUpdate Document From Text
Replace a document's content with new raw text or a JSON object and reprocess it. Returns a status field for the update. Use ragie_document_update_raw to overwrite a text document. Use ragie_document_update_from_url to replace it with a file from a URL. Requires a document id from ragie_documents_list. Processing is asynchronous: poll ragie_document_get until status is ready.
- Idempotent
Inputs
datastringrequired- New document content as plain text, or as a JSON object. Example: "Refunds are accepted within 60 days of purchase."
document_idstringrequired- ID of the document. Get it from ragie_documents_list or from the response of a create tool.
partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
ragie_instruction_createCreate an instruction that extracts structured entities from documents as they are created or updated.WriteCreate Instruction
Create an instruction that extracts structured entities from documents as they are created or updated. Returns the new instruction with its id, name, prompt, entity_schema, scope, active flag and timestamps. Use ragie_instruction_create to define automatic extraction. Extracted data is read with ragie_entities_list_by_document or ragie_entities_list_by_instruction. The name must be unique.
Inputs
entity_schemaobjectrequired- JSON Schema describing the structure of each extracted entity. Example: {"type": "object", "properties": {"parties": {"type": "array", "items": {"type": "string"}}}, "required": ["parties"]}.
namestringrequired- Unique name for the instruction. Example: Contract Parties
promptstringrequired- Natural-language instruction applied to each document or chunk. The result is stored as an entity matching entity_schema. Example: Extract the names of all parties to the contract.
activeboolean- Whether the instruction runs on documents when they are created or their file is updated. Defaults to true.default
true context_templatestring- Optional mustache-style template prepended to the content sent for extraction. Variables include document.name, document.type, document.source and document.metadata values. Example: Document: {{document.name}}
filterobject- Metadata filter; the instruction runs only on documents whose metadata matches. Example: {"department": {"$eq": "legal"}}.
partitionstring- Partition the instruction applies to. If set, it runs only for documents in that partition.
scopestring- Whether the instruction runs on the whole document or on each chunk. Use document for summaries or sentiment; use chunk for fine-grained extraction. Defaults to chunk.one of
documentchunkdefaultchunk
ragie_instruction_updateChange an existing entity-extraction instruction, such as its name, prompt, schema, scope, filter or active flag.WriteUpdate Instruction
Change an existing entity-extraction instruction, such as its name, prompt, schema, scope, filter or active flag. Returns the updated instruction. Use ragie_instruction_update to edit or pause an instruction. Use ragie_instruction_create for a new one. Requires an instruction id from ragie_instructions_list. Only the fields you provide are changed.
- Idempotent
Inputs
instruction_idstringrequired- ID of the instruction. Get it from ragie_instructions_list.
activeboolean- Whether the instruction runs on documents when they are created or updated.
context_templatestring- New mustache-style template prepended to the content sent for extraction.
entity_schemaobject- New JSON Schema for the extracted entities.
filterobject- New metadata filter; the instruction runs only on documents whose metadata matches.
namestring- New unique name for the instruction.
promptstring- New natural-language instruction applied to documents.
scopestring- Run on the whole document or on each chunk.one of
documentchunk
ragie_partition_createCreate a partition to isolate a set of documents, optionally with monthly or maximum usage limits.WriteCreate Partition
Create a partition to isolate a set of documents, optionally with monthly or maximum usage limits. Returns the new partition with name, is_default, description, context_aware, metadata_schema and limits. Use ragie_partition_create to set up a partition ahead of time with limits. Partitions are also created automatically when a document is added to a new partition name. Names must be lowercase alphanumeric and may include _ and -.
Inputs
namestringrequired- Partition name: lowercase letters and digits, with _ and - allowed. Example: customer-acme
descriptionstring- Description of the partition. Example: Documents for the Acme customer.
metadata_schemaobject- Optional JSON Schema subset describing the metadata of documents in this partition, used to generate filters. Detailed field descriptions help LLMs build filters. Example: {"department": {"type": "string", "description": "Owning department"}}.
pages_hosted_limit_maxinteger- Maximum limit, in pages, for hosted documents in the partition.
pages_hosted_limit_monthlyinteger- Monthly limit of hosted pages added in the current month in the partition.
pages_processed_limit_maxinteger- Maximum limit, in pages, for processed documents in the partition.
pages_processed_limit_monthlyinteger- Monthly limit, in pages, for processed documents in the partition.
ragie_partition_updateChange a partition's description, context-aware setting or metadata schema.WriteUpdate Partition
Change a partition's description, context-aware setting or metadata schema. Returns the updated partition with name, description, context_aware, metadata_schema, limits and stats. Use ragie_partition_update to edit an existing partition. Use ragie_partition_create for a new one. Requires a partition name from ragie_partitions_list. Only the fields you provide are changed.
- Idempotent
Inputs
partition_idstringrequired- Name of the partition (its identifier). Get it from ragie_partitions_list.
context_awareboolean- Enable context-aware descriptions for the partition.
descriptionstring- New description of the partition.
metadata_schemaobject- New metadata schema for the partition, as a map of field name to JSON Schema, used to generate filters.
ragie_document_deletePermanently delete a document and its chunks from Ragie.DestructiveDelete Document
Permanently delete a document and its chunks from Ragie. Returns a status field for the deletion. Use ragie_document_delete only when the document should be gone for good; it cannot be undone. Requires a document id from ragie_documents_list.
- Idempotent
Inputs
document_idstringrequired- ID of the document. Get it from ragie_documents_list or from the response of a create tool.
asyncboolean- Delete in the background. If true, deletion runs asynchronously. Defaults to false.
partitionstring- Partition to scope this request to. Omit to use the account default (the default partition for accounts created after 2025-01-09; older accounts without strict partition scoping search all partitions). Partition names are lowercase alphanumeric and may include _ and -.
ragie_instruction_deleteDelete an entity-extraction instruction.DestructiveDelete Instruction
Delete an entity-extraction instruction. Returns a status field for the deletion. Use ragie_instruction_delete to remove an instruction for good. Use ragie_instruction_update with active set to false to pause it instead. Requires an instruction id from ragie_instructions_list.
- Idempotent
Inputs
instruction_idstringrequired- ID of the instruction. Get it from ragie_instructions_list.
ragie_partition_deleteDelete a partition and all documents inside it.DestructiveDelete Partition
Delete a partition and all documents inside it. Returns a message field confirming the deletion. Use ragie_partition_delete only when the whole partition and its documents should be gone for good; it cannot be undone. Requires a partition name from ragie_partitions_list.
- Idempotent
Inputs
partition_idstringrequired- Name of the partition (its identifier). Get it from ragie_partitions_list.
asyncboolean- Delete in the background. If true, deletion runs asynchronously. Defaults to false.
No tools match.
