Skip to main content
You must have at least one Publisher in your organization before uploading. See Manage Publishers.
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 "files=@/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 "files=@..." 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 "files=@/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