Skip to navigation

Extract a file into the ontology (doc + space + org levels)

View as Markdown

Extracts entities and relations from a file once and populates the document, space, and organization graph levels together. JSON body: fileId (required, non-empty). The file must belong to :spaceId or the request returns 404. Returns { fileId, results }, one IngestNamespaceResult per graph level with status (ok | error) and the entities/mentions/edges counts written. Idempotent — re-ingesting creates or enhances the existing graphs. Requires space:contribute on :spaceId; lacking write permission is a 403 (a missing space:read prerequisite would be a 404).

Authentication

AuthorizationBearer

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

Path parameters

spaceIdstringRequired

Request

This endpoint expects an object.
fileIdstringRequired>=1 character

Response

Per-level ingestion results with the counts written.

fileIdstring
resultslist of objects