Ingest a single document

POST

/data/v1/ingest/document

• Production server

Ingest a single document into the knowledge base. The document is chunked, embedded, and stored in Milvus. Entity extraction runs in the background.

Idempotent: duplicate documents are detected and skipped based on content hashing and source_id matching.

Authorizations

• BearerAuth

Request Body ^required

object

content

required

The full document text to ingest

string

metadata

required

object

source

required

Source identifier (e.g. ‘manual’, ‘wikipedia’, ‘eve_sde’)

string

manual

source_id

Unique ID for deduplication (same source_id + source = duplicate)

string

title

required

Document title

string

url

Source URL (optional)

string

content_type

Content category (e.g. ‘article’, ‘game_item’, ‘docs’)

string

tags

Categorization tags

Array<string>

custom

Arbitrary custom metadata

object

key

additional properties

any

Responses

200

Successful response (or duplicate detected)

object

document_id

ID of the first chunk (empty if no content)

string

chunks_created

Number of chunks created (0 if duplicate)

integer

status

Ingestion result status

string

Allowed values: success duplicate empty failed

message

Human-readable result message

string

400

Invalid request

object

error

object

message

string

type

string

code

string

param

string

401

Invalid or missing API key

object

error

object

message

string

type

string

code

string

param

string