Skip to main content
POST
/
ingestion
/
v1
/
real_time_upload
Real-time ingestion
curl --request POST \
  --url https://platform.ai.gloo.com/ingestion/v1/real_time_upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "content": "This is the full text content that needs to be processed and indexed for search. It is the only required field.",
  "filename": "sample_document_name.txt",
  "producer_id": "producer-123",
  "publisher_id": "550e8400-e29b-41d4-a716-446655440000",
  "tradition": "Catholic",
  "evergreen": true,
  "drm": [
    "aspen",
    "kallm"
  ],
  "author": [
    "Jane Doe",
    "John Smith"
  ],
  "isbn": "978-3-16-148410-0",
  "item_title": "Main Document Title",
  "item_subtitle": "An informative subtitle",
  "item_image": "https://example.com/images/document-cover.jpg",
  "item_url": "https://example.com/original-content",
  "item_file": "https://example.com/downloads/document.pdf",
  "item_summary": "A brief summary of the document's content and purpose.",
  "item_number": "DOC-2023-001",
  "item_extra": "Additional information about this item",
  "item_tags": [
    "documentation",
    "api",
    "tutorial",
    "reference"
  ],
  "h2_title": "Section Heading",
  "h2_subtitle": "Section Subheading",
  "h2_image": "https://example.com/images/section-image.jpg",
  "h2_url": "https://example.com/section",
  "h2_file": "https://example.com/downloads/section.pdf",
  "h2_summary": "Summary of this specific section.",
  "h2_number": "2.1",
  "h2_extra": "Additional section metadata",
  "h3_title": "Subsection Heading",
  "h3_subtitle": "Subsection Subheading",
  "h3_image": "https://example.com/images/subsection-image.jpg",
  "h3_url": "https://example.com/subsection",
  "h3_file": "https://example.com/downloads/subsection.pdf",
  "h3_summary": "Summary of this specific subsection.",
  "h3_number": "2.1.3",
  "h3_extra": "Additional subsection metadata",
  "type": "Article",
  "duration": "15 minutes",
  "pages": "12",
  "publication_date": "2023-07-15",
  "hosted_url": "https://cdn.example.com/hosted-content",
  "pub_type": "technical"
}
EOF

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.

This endpoint has been deprecated. Use the Direct File Upload API instead.

​
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.

Body

application/json

The request body should be a JSON object with the following structure:

​
publisher_id
string<uuid>
required

UUID of the publisher associated with the content. This must be associated with your organization.

​
content
string
required

The actual text content to be ingested and chunked.

​
filename
string

Custom filename for this content.

​
type
string

Content type (e.g., article, blog, tutorial).

​
item_title
string

Title of the content item.

​
item_subtitle
string

Subtitle of the content item.

​
item_summary
string

Brief summary of the content.

​
item_image
string<uri>

URL to image associated with the content.

​
item_url
string<uri>

URL to the original content.

​
item_file
string<uri>

URL to a file associated with the content.

​
item_number
string

Identifying number for the content item.

​
item_extra
string

Additional information about the content item.

​
item_tags

Tags associated with the content (can be array or comma-separated string).

​
author

Author(s) of the content (can be array or comma-separated string).

​
isbn
string

ISBN if content is from a book.

​
publication_date
string<date>

Date when the content was published (recommended format: YYYY-MM-DD).

​
producer_id
string

ID of the content producer.

​
tradition
string

Religious tradition (if applicable).

​
pub_type
string

Publication type.

​
hosted_url
string<uri>

URL where the content is hosted.

​
pages
string

Number of pages (for documents).

​
duration
string

Duration (for audio/video content).

​
h2_title
string

Title for level 2 heading/section.

​
h2_subtitle
string

Subtitle for level 2 heading/section.

​
h2_image
string<uri>

Image URL for level 2 heading/section.

​
h2_url
string<uri>

URL for level 2 heading/section.

​
h2_file
string<uri>

File URL for level 2 heading/section.

​
h2_summary
string

Summary for level 2 heading/section.

​
h2_number
string

Number for level 2 heading/section.

​
h2_extra
string

Additional info for level 2 heading/section.

​
h3_title
string

Title for level 3 heading/section.

​
h3_subtitle
string

Subtitle for level 3 heading/section.

​
h3_image
string<uri>

Image URL for level 3 heading/section.

​
h3_url
string<uri>

URL for level 3 heading/section.

​
h3_file
string<uri>

File URL for level 3 heading/section.

​
h3_summary
string

Summary for level 3 heading/section.

Response

Content successfully uploaded and processed.