Skip to main content
Upload once. Search instantly. Build faster. The Data Engine Files API lets you send any file directly to Gloo AI for real-time processing and indexing. Within minutes, your content becomes searchable, context-aware, and ready for AI-driven interactions—no preprocessing or custom pipelines required.

​
Why It Matters

Developers often spend weeks wiring together upload, parsing, and indexing pipelines. The Data Engine Files API eliminates that complexity:
  • Unified ingestion for all major file types
  • Automatic parsing and indexing with no manual steps
  • Instant availability in your Gloo AI workspace
  • Scalable performance for millions of files

​
Prerequisites

Before starting, ensure you have:
The Files API requires Bearer token authentication. If you haven’t set up authentication yet, follow the Authentication Tutorial.

​
Upload Files

Send files directly to the ingestion endpoint. You can mix file types freely—the endpoint automatically detects and processes each format. 
curl -X POST https://platform.ai.gloo.com/ingestion/v2/files \
  -H "Authorization: Bearer $GLOO_API_KEY" \
  -F "file=@/path/to/your/document.pdf"
Example Response: 
{
  "success": true,
  "message": "File processing started in background.",
  "ingesting": ["c999008e-de60-495c-8c9f-6a4b59cdb04b"],
  "duplicates": []
}
You can upload multiple files in a single request by adding multiple -F "file=@..." parameters.

​
Upload with Your Internal ID

Use the producer_id query parameter to associate your internal ID with the uploaded file. This makes it easier to look up items later using your own identifiers.
Shell
curl -X POST "https://platform.ai.gloo.com/ingestion/v2/files?producer_id=your-internal-id" \
  -H "Authorization: Bearer $GLOO_API_KEY" \
  -F "file=@/path/to/your/document.pdf"
If producer_id is supplied with a multi-file upload, the ID will be ignored. Producer IDs must have a one-to-one relationship with a file.

​
Next Steps