Skip to main content
POST
/
ingestion
/
v2
/
files
Upload Files
curl --request POST \
  --url https://platform.ai.gloo.com/ingestion/v2/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'publisher_id=<string>' \
  --form 'files=<string>' \
  --form files.items='@example-file'
{
  "success": true,
  "message": "<string>",
  "ingesting": [
    "<string>"
  ],
  "duplicates": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.gloo.com/llms.txt

Use this file to discover all available pages before exploring further.

Error Reference: Ingestion

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

​
Authentication

The API requires a JWT token with specific claims to authorize access. The token must be associated with a Client ID that has access to the specified publisher. The system validates that the organization associated with your Client ID has permission to access the publisher specified in your request.

​
JWT Token Requirements

Your JWT must include the following claims:
  • A sub claim containing your API Client ID.
  • A scope claim that includes api/access.
You will only be able to send content to a publisher that belongs to your organization. Please double-check the publisher_id field in the request body for accuracy.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

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

Response

File ingestion queued

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