Get one entity and its grounded mentions in a space

GET

/spaces/:spaceId/ontology/entities/:entityId

GET

/spaces/:spaceId/ontology/entities/:entityId

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

200Retrieved

1 {
2   "entity": {
3     "id": "org-12345",
4     "type": "organization",
5     "name": "Acme Corporation",
6     "key": "acme-corp"
7   },
8   "mentions": [
9     {
10       "fileId": "file-67890",
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-11223",
25       "page": null,
26       "bbox": null,
27       "text": "Acme Corporation reported record earnings this quarter.",
28       "startSeconds": 12.5,
29       "endSeconds": 18,
30       "speaker": "Jane Doe"
31     }
32   ]
33 }

Returns { entity, mentions } for a single entity in a space’s graph. entity (or null if the id is unknown in this space) carries id, type, name, key. mentions are the grounded occurrences: each has fileId, text, and best-effort grounding — page + bbox ({x,y,width,height}) for documents, or startSeconds/endSeconds/speaker for audio transcripts (fields are null when not applicable). Requires space:read on :spaceId; missing access surfaces as a 404.

Returns `{ entity, mentions }` for a single entity in a space's graph. `entity` (or `null` if the id is unknown in this space) carries `id`, `type`, `name`, `key`. `mentions` are the grounded occurrences: each has `fileId`, `text`, and best-effort grounding — `page` + `bbox` (`{x,y,width,height}`) for documents, or `startSeconds`/`endSeconds`/`speaker` for audio transcripts (fields are `null` when not applicable). Requires `space:read` on `:spaceId`; missing access surfaces as a 404.

Authentication

AuthorizationBearer

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

Path parameters

spaceIdstringRequired

entityIdstringRequired

Response

The entity (or null) and its grounded mentions.

entityobject or null

Null when the id is unknown in this graph.

mentionslist of objects