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

POST

/spaces/:spaceId/ontology/ingest

POST

/spaces/:spaceId/ontology/ingest

$ curl -X POST https://api.cloudraker.com/spaces/spaceId/ontology/ingest \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "fileId": "4f6f1c1e-1b2a-4d3c-9e8f-7a6b5c4d3e2f"
> }'

200Successful

1 {
2   "fileId": "4f6f1c1e-1b2a-4d3c-9e8f-7a6b5c4d3e2f",
3   "results": [
4     {
5       "namespace": "document",
6       "status": "ok",
7       "entities": 45,
8       "mentions": 120,
9       "edges": 75,
10       "error": ""
11     },
12     {
13       "namespace": "space",
14       "status": "ok",
15       "entities": 30,
16       "mentions": 80,
17       "edges": 50,
18       "error": ""
19     },
20     {
21       "namespace": "organization",
22       "status": "ok",
23       "entities": 15,
24       "mentions": 40,
25       "edges": 25,
26       "error": ""
27     }
28   ]
29 }

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).

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