Skip to main content
POST
Upload Files

Guide: Upload Content

Send files to Gloo AI for processing and indexing.

Guide: How Chunking Works

What happens to your files after upload, and how to prepare content for search.

Error Reference: Ingestion

Common errors: publisher org mismatch, publisher not found, file read errors, duplicate uploads in the response body.

Authentication

The API requires an API key with access to the specified publisher. Your API key’s organization must have permission to access that publisher.
You can only send content to a publisher that belongs to your organization, so double-check the publisher_id in the request body.

Authorizations

Authorization
string
header
default:Bearer <api-key>
required

Bearer authentication header of the form Bearer <api-key>, where <api-key> is your API key.

Query Parameters

update
string

Optional item_id to update (replacing existing content)

producer_id
string

Optional producer-specific identifier for the uploaded file. When provided, only one file may be uploaded in the request.

Body

multipart/form-data
publisher_id
string
required

Publisher ID

files
file[]
required

Files to upload

chunk_strategy
enum<string>
default:by_title

How documents are split. by_title starts a new chunk at a heading when the section before it would not fit. basic packs text up to the chunk size and ignores headings. Audio and video transcripts and JSON files ignore this.

Available options:
by_title,
basic
chunk_size
integer
default:1500

The most characters a chunk can hold. Audio and video transcripts and JSON files ignore this.

Required range: 200 <= x <= 4000
chunk_overlap
integer
default:200

Characters each piece of a split paragraph repeats from the piece before it. Must be smaller than chunk_size. Audio and video transcripts and JSON files ignore this.

Required range: 0 <= x <= 1000

Response

File ingestion queued

success
boolean
required
message
string
required
ingesting
string[]
required
duplicates
string[]
required