DocumentationIngestion API
3 min readAugust 2026
Automation API
Try in ConsoleProgrammatic Ingestion REST API
Automate your knowledge sync workflows by pushing files and database records directly to the ToolsWallet Ingestion API from your backend servers, cron jobs, or CI/CD pipelines.
1. Upload File via API (Multipart Form-Data)
Upload a .json, .txt, or .md file directly to a Knowledge Base:
Endpoint: POST https://rag.toolswallet.dev/api/ingest/file
cURL Command:
BASH
curl -X POST https://rag.toolswallet.dev/api/ingest/file \
-H "Authorization: Bearer YOUR_AUTH_TOKEN" \
-F "ragId=YOUR_RAG_ID" \
-F "file=@faq.json"2. Sync Raw Text or JSON Snippet
Push raw markdown or JSON string data programmatically:
Endpoint: POST https://rag.toolswallet.dev/api/ingest/text
cURL Command:
BASH
curl -X POST https://rag.toolswallet.dev/api/ingest/text \
-H "Authorization: Bearer YOUR_AUTH_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"ragId": "YOUR_RAG_ID",
"text": "# Refund Policy\n100% full refund within 30 days of purchase."
}'3. Deduplication & Response Format
The API returns the exact count of new records indexed and your total quota status:
JSON
{
"success": true,
"message": "Successfully indexed 4 passages into Knowledge Base (5 / 25 total).",
"chunksIndexed": 4,
"totalChunks": 5,
"quotaLimit": 25
}Ready to build your Custom RAG?
Deploy in under 3 minutes with 2 free RAG knowledge bases.