Linked Insight Ids
Changed onInsight ids linked to the requested entity / event scope.
The browser already holds the whole store from /all-insights, so scoping a browse only needs graph adjacency: it intersects these ids with the corpus it has instead of refetching a listing. Adjacency is not user-specific — provider access is already applied to the store the ids are intersected with.
Scopes AND together, the same way the paginated listing stacks its entity and event pre-filters. Adjacency does not vary with subject/topic/dataset filters, so those are not accepted here — the caller narrows the intersection it already holds.
candidate_id asks the picker's second question against the same intersection: which of the entities on screen would empty it. That belongs here rather than on the entity listing, which is response-cached across all of its filters — folding a per-selection answer into that key would give every distinct selection its own copy of every page, for one bit per row.
Request
- Base URL: https://api.carbonarc.co (the document declares no server; this is the origin it was published from)
- URL: https://api.carbonarc.co/v2/ontology/insights/linked
- Auth: none declared
Query parameters
Entity carc_ids (paired with entity_representation)
Representations paired 1:1 with entity_id
carc_id of an event EntityRepresentation (paired with event_representation).
Representation type of the event node (e.g. 'corpeventc').
carc_id of an EventCategory — insights linked to any event under it.
carc_ids of entities being offered as additions to the scope (paired with candidate_representation). Each one is reported back in incompatible_entities if it shares no insight with the scope.
Representations paired 1:1 with candidate_id
Request body
Response
Successful Response
Changes
- info
added the new optional
queryrequest parametercandidate_id - info
added the new optional
queryrequest parametercandidate_representation - info
added the optional property
to the response with the status
- info
- info
endpoint added
- info