Skip to main content
GET
Get a knowledge case
The reference panel describes the current v3 operation. The notes below describe its v2 compatibility API. Follow the v3 request schema for current calls: v3 can move identifiers from the body or query into the URL. Keep the v2 method, path, and payload together when using the compatibility API.

v2 compatibility notes

GET /api/v2/knowledge/cases/get?entryId=<id> returns one case with its text, its grade and counters, its steward and verification interval, and its version: the text version to name as expectedVersion when you edit the case. It needs knowledge:read. The text is the stored content, or the case’s first 50 chunks joined in order; textTruncated is true when the case is longer. A malformed, missing, deleted, unreadable or source-restricted case answers the same 404 resource_missing. For an exact duplicate check, use GET /api/v2/knowledge/cases/get?namespace=<namespace>&key=<caseKey> instead. The indexed lookup selects the active live case with that exact key in that namespace, under the same read checks. Supply either entryId alone or both namespace and key; mixed, incomplete, repeated or unknown selectors answer 400 bad_request. Keys are 1–200 characters. A person’s own key or a platform key can name a Customer’s customer:<canonicalCustomerId> namespace when it may act for that Customer’s organization; see Selecting a Customer’s partition. Naming one never broadens ambient discovery.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

entryId
string

The case id (id from listKnowledgeCases).

Minimum string length: 1
namespace
string

Exact Knowledge namespace; requires key instead of entryId.

Minimum string length: 1
key
string

Exact stable artifact key; requires namespace instead of entryId.

Required string length: 1 - 200
actingFor
string

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.

Required string length: 1 - 200

Response

Knowledge case

data
object
required

One knowledge case and its text: the stored content, or its first 50 chunks joined in order (textTruncated when it is longer). Never carries who ingested, graded, verified, deleted or archived the case, its evidence or evidence notes, its RAG id, storage, content hash, source access, owning External App or home org unit.

meta
object
required