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>"
  ]
}

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)

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