Skip to main content
PUT
Replace a document

Authorizations

Authorization
string
header
required

API key issued by EverOS, sent as Authorization: Bearer <api_key>.

Path Parameters

kb_id
string
required
doc_id
string
required

Body

application/json

Public POST/PUT documents request body (design §3.2 / §3.3). content is the object to ingest (its uri = the SMM object_key). On PUT the doc_id rides the path, not the body; on POST no id is supplied — the engine mints it.

title
string
required

Human-readable name for the document. Until the async ingest finishes this is the only handle the caller has — the document id is minted downstream, so GET .../documents is resolved by title.

Minimum string length: 1
content
ContentItem · object
required

The object to ingest (its uri = the SMM object_key)

category_id
string
default:""

Category id in this kb; omit for LLM auto-classify

Response

Accepted for asynchronous re-ingest of this document id. The body carries status and task_id only.

request_id
string
required

Request trace id (peer to data)

data
DocIngestData · object
required

Endpoint-defined business result