List knowledge records
Page every record of the requested kinds a credential can read, complete or refused. Requires knowledge:read.
v2 compatibility notes
POST /api/v2/knowledge/records/list answers every record of the requested kinds in the credential’s readable namespaces, or refuses. It never answers a partial list as complete. It needs knowledge:read. Machine credentials still refuse a cohort containing a source-restricted record (permission_denied/restricted_records); a successful machine list reports omitted: {restricted: 0}. Credential ownership does not confer person access. See Knowledge records for what a record carries and when a kind is complete.
(kind, externalId) order. count and digest describe the whole admitted list, and omitted.restricted counts inaccessible active restricted candidates of the requested source/kinds before filtering. The count is pinned across every door page; an omission-only change also refuses changed. nextCursor is set while records remain. Every page reads the complete list again and is pinned to it: when the records change between pages, the page refuses changed, and you start again without a cursor. A cursor sent with a different request refuses invalid_filter.
Every refusal answers 200 with its status and reason:
omitted object changes the current strict output contract. Released snapshots remain
immutable; the separately authorized containing MCP release must satisfy its existing next-major
compatibility requirements. No new request field selects a person or supplies a reader.Authorizations
Body
The orgUnitId of the one external organization this request acts for (listed by GET /api/v2/knowledge/scopes/list with scopeType organization). It needs knowledge:read (knowledge:manage for an edit) at that organization's own unit or at platform scope; a grant at Gloo's root does not reach it. Absent, the request reads Gloo's knowledge only and never an organization's. One organization per request. A refused actingFor answers 403; an admitted one is audited before the answer, and a read whose audit cannot be written answers 500.
1 - 200Response
One page of the complete list, or a refusal
One page of a complete record list, or a refusal. complete: at most 500 records in (kind, externalId) order, count and digest of the complete admitted list, and omitted.restricted counting inaccessible active restricted candidates of the requested kinds before filtering (the same whole-cohort count on every door page), and nextCursor while records remain. Otherwise a refusal with its reason: incomplete, stale, too_large, not_listable, ambiguous_source, permission_denied, invalid_filter or changed.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9

