List knowledge cases
Page the knowledge cases a credential can read, filtered and sorted as the Console knowledge list. Requires knowledge:read.
v2 compatibility notes
GET /api/v2/knowledge/cases/list lists the cases in the credential’s readable namespaces, or in the one readable namespace it names, newest first by default. It needs knowledge:read. A source-restricted case is never returned, even to your own MCP key. See Knowledge cases for what a case carries and what it never carries.
limit candidate rows and returns those that match and are readable, so a page may hold fewer cases than limit, or none, while meta.hasMore is true. Follow meta.nextCursor until it is null. Any other parameter, a value outside its set, an empty or repeated single-valued parameter, or a cursor Forge cannot read answers 400 bad_request. A title sort answers 400 while case titles are still being prepared after an upgrade.
An empty search page is not proof that a key is unused. Use Get case by exact namespace and key for deterministic SOP duplicate checks. A Personal MCP key can explicitly select one authorized customer:<canonicalCustomerId> namespace; omitting it never enumerates Customer partitions.
Authorizations
Query Parameters
Only entries from these sources. Repeat the parameter for several values; any other value answers 400.
upload, chat_save, auto_ingest, session_close, memory_promotion_agent, memory_promotion_human, memory_promotion_threshold, memory_promotion_compression, agent_record, external_sync 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
Readable knowledge cases

