List Knowledge Edges

GET /knowledge-edges

Every relation the caller can see, newest first.

?status=proposed is the review queue the organize stage has been filling since M7 with nothing on the other end of it. The row carries curated_by_id and curated_at, which is how a second curator can tell an unreviewed proposal from one somebody already ruled on.

Role floor

Requires member or above. The floor is a minimum, not a grant: scope filtering still applies on top of it, and a resource in another tenant answers 404 rather than 403.

Parameters

Name	In	Type		Notes
from_item_id	query	string (uuid) | null	optional	the recorded tail
to_item_id	query	string (uuid) | null	optional	the recorded head
item_id	query	string (uuid) | null	optional	either endpoint: every relation touching this item
kind	query	part_of | supports | contradicts | derived_from | supersedes | relates_to | answers | shares_topic | null	optional	—
status	query	proposed | confirmed | rejected | null	optional	‘proposed’ is the review queue
limit	query	integer	optional	Default 50. min 1 max 200
cursor	query	string | null	optional	—
offset	query	integer | null	optional	min 0

Responses

Status	Description	Body
200	Successful Response	Page_KnowledgeEdgeView_
422	Validation Error	HTTPValidationError

Only the success paths are declared

Any operation may also answer any status in the error catalogue, and every failure body is the platform envelope — including the 422 this document types as HTTPValidationError.

Example

curl -X GET https://your-deployment.example.com/knowledge-edges \
  -H "Authorization: Bearer $COBRE_TOKEN"

Response — Page_KnowledgeEdgeView_

Field	Type		Notes
items	KnowledgeEdgeView[]	required	—
next_cursor	string | null	optional	—
total	integer | null	optional	—