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 '{
  "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",
  "denomination": "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"
}'

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

The body is of type object.

Response

200

Content successfully uploaded and processed.