Upload Remote Content

Upload content from a remote source (S3, GCS, SharePoint, GitHub) to the knowledge base. Content is processed asynchronously in the background.

POST /knowledge/remote-content

Upload Remote Content

cURL

curl --request POST \
  --url https://api.example.com/knowledge/remote-content \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'config_id=<string>' \
  --data 'path=<string>' \
  --data 'name=<string>' \
  --data 'description=<string>' \
  --data 'metadata=<string>' \
  --data 'reader_id=<string>' \
  --data 'chunker=<string>' \
  --data chunk_size=123 \
  --data chunk_overlap=123

202

{
  "id": "content-456",
  "name": "reports/q1-2024.pdf",
  "description": "Q1 Report from S3",
  "metadata": {
    "source": "s3-docs"
  },
  "status": "processing"
}

Authorizations

Authorization · string · header · required

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

Query Parameters

db_id · string | null

Database ID to use for content storage

Body

application/x-www-form-urlencoded

config_id · string · required

ID of the configured remote content source (from /knowledge/config)

path · string · required

Path to file or folder in the remote source

name · string | null

Content name (auto-generated if not provided)

description · string | null

Content description

metadata · string | null

JSON metadata object

reader_id · string | null

ID of the reader to use for processing

chunker · string | null

Chunking strategy to apply

chunk_size · integer | null

Chunk size for processing

chunk_overlap · integer | null

Chunk overlap for processing

Response

202

application/json

Remote content upload accepted for processing

id · string · required

Unique identifier for the content

name · string | null

Name of the content

description · string | null

Description of the content

type · string | null

MIME type of the content

size · string | null

Size of the content in bytes

linked_to · string | null

ID of related content if linked

metadata · Metadata · object

Additional metadata as key-value pairs

access_count · integer | null

Number of times content has been accessed

Required range: x >= 0

status · enum<string> | null

Processing status of the content

Available options: processing, completed, failed

status_message · string | null

Status message or error details

created_at · string<date-time> | null

Timestamp when content was created

updated_at · string<date-time> | null

Timestamp when content was last updated