Get one entity and its mentions from the org-wide graph

GET

/ontology/entities/:entityId

GET

/ontology/entities/:entityId

$ curl https://api.cloudraker.com/ontology/entities/entityId \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "entity": {
3     "id": "org-9f8b7c6d-1234-4a56-b789-0a1b2c3d4e5f",
4     "type": "organization",
5     "name": "Acme Corporation",
6     "key": "acme-corp"
7   },
8   "mentions": [
9     {
10       "fileId": "file-20240401-xyz123",
11       "page": 3,
12       "bbox": {
13         "x": 0.15,
14         "y": 0.25,
15         "width": 0.3,
16         "height": 0.1
17       },
18       "text": "Acme Corporation announced a new product line.",
19       "startSeconds": null,
20       "endSeconds": null,
21       "speaker": null
22     },
23     {
24       "fileId": "audio-20240315-abc789",
25       "page": null,
26       "bbox": null,
27       "text": "The CEO of Acme Corporation spoke at the conference.",
28       "startSeconds": 45.2,
29       "endSeconds": 52.7,
30       "speaker": "Speaker 1"
31     }
32   ]
33 }

Returns { entity, mentions } for an entity in the org-wide (org) graph. entity is null for an unknown id; otherwise { id, type, name, key }. mentions carry fileId, text, and best-effort grounding (page+bbox for documents, startSeconds/endSeconds/speaker for audio). Org-admin only — requires the admin role; non-admins get a 403.

Returns `{ entity, mentions }` for an entity in the org-wide (`org`) graph. `entity` is `null` for an unknown id; otherwise `{ id, type, name, key }`. `mentions` carry `fileId`, `text`, and best-effort grounding (`page`+`bbox` for documents, `startSeconds`/`endSeconds`/`speaker` for audio). Org-admin only — requires the admin role; non-admins get a 403.

Authentication

AuthorizationBearer

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

Path parameters

entityIdstringRequired

Response

The entity (or null) and its mentions across the organization.

entityobject or null

Null when the id is unknown in this graph.

mentionslist of objects