Skip to main content
GET
List knowledge review items
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/listReviews lists what waits for a steward’s judgment in the knowledge review queue, and why, newest first. It needs knowledge:read held at the deployment root (a platform grant or the root-org-unit grant). A credential that holds it only below the root answers 403 permission_denied with requiredPermission: "knowledge:read". A holder of knowledge:manage decides an item with POST /api/v2/knowledge/decideReview (MCP forge_decide_knowledge_review), or a person in Console through the item’s handoff link. Each pending item carries that handoff to the Console review page. See Review queue and Learning feed. Any other parameter, a value outside these sets, or a cursor this route did not issue answers 400 bad_request. The cursor is the queue position of the last item returned, so an item decided between pages never makes the next page skip one that is still pending. The queue is read in a bounded window of the newest 500 items; when that read stops with items left, meta.partial is true.

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

status
enum<string>[]

Statuses to list; pending when omitted. Repeat the parameter for several values; any other value answers 400.

Available options:
pending,
approved,
rejected,
auto_resolved
kind
enum<string>[]

Review kinds to list; every kind when omitted. Repeat the parameter for several values; any other value answers 400.

Available options:
contested,
approval,
conflict,
duplicate,
stale,
verification_due
namespace
string

One knowledge namespace (for example company or team:<orgUnitId>). A namespace outside the caller's readable set answers 403.

Minimum string length: 1
cursor
string

The meta.nextCursor from the previous page; omit for the first page.

limit
integer
default:25

Items per page, 1-100 (default 25); any other value answers 400.

Required range: 1 <= x <= 100

Response

One page of review items

data
object[]
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.