> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Review knowledge

> Resolve knowledge review items and audit the activity that changed the knowledge base.

Use **Knowledge → Review** (`/knowledge/review`) to decide whether knowledge should be verified, promoted, retained, merged, or retired. The page requires `knowledge:read`; resolving an item requires `knowledge:manage`, and you must still be able to read the artifacts the decision changes.

**Queue** contains steward work. **Activity** shows learning and completed changes. Start in Queue when a decision is pending; use Activity to understand what changed afterward.

![Review knowledge (light)](https://mintcdn.com/gloo-b243725a/xyq5perq6SLByPBn/forge/images/console/knowledge/review-light.png?fit=max\&auto=format\&n=xyq5perq6SLByPBn\&q=85\&s=4546d06a6bbfbb7c9492e1330fdb9833)

Review knowledge — Forge Console at `/knowledge/review`

## What you can do

* Decide one review item with a note. See [Review one item](#review-one-item).
* Check what a decision changes before you confirm it. See [Understand what a decision changes](#understand-what-a-decision-changes).
* Approve or decline pending approval items in bulk. See [Decide approval items in bulk](#decide-approval-items-in-bulk).
* Recover from a refused decision. See [Recover from a refusal](#recover-from-a-refusal).

## Review one item

1. Narrow the queue by scope, kind, status, or search. The default queue reads pending items and groups them by kind.
2. Open an item. Inspect its artifact, source, evidence, current grade, and any related artifact before choosing a result.
3. Read the offered action and its confirmation text. Actions depend on the item's kind and current artifact state.
4. Enter a **Note** of 1–500 characters explaining the decision, then choose **Confirm**. Use **Back to the item** to return without deciding.
5. Check that the item leaves the pending queue and inspect Activity when you need the recorded outcome.

The open item is stored in the URL as `item`, so you can share its Console URL with another authorized reviewer. The link does not grant access to the underlying knowledge.

## Understand what a decision changes

| Decision or item | Effect |
| - | - |
| **Approve** on new knowledge awaiting review | Records verification of the text; its grade and search rank stay the same. |
| **Verify knowledge artifact** | Records human verification and starts the next verification interval; it does not change grade. |
| Change grade | Changes the artifact's retrieval weight or retires it. The offered choices depend on the item. |
| **Decline** on a provisional approval | Leaves the artifact provisional and closes the review item. |
| **Keep as is**, **Keep both**, or **Keep** | Retains the current artifact state according to the item's confirmation text. |
| Merge | Requires the artifacts still to satisfy merge rules; review which artifact will be retained. |

“Verified” and “proven” answer different questions. Verification records a review of the current text; the grade determines how retrieval weights it. Read the confirmation text rather than assuming every approval promotes an artifact.

## Decide approval items in bulk

With management access, select pending approval rows and enter one note for every decision. Choose **Approve N as proven** or **Decline N**. Bulk approval makes these provisional artifacts proven; it differs from the **Approve** action on a new `needs_review` item.

Each item is decided independently. The result reports how many were decided and lists refused artifacts with reasons. Accepted items leave the selection; retryable failures stay selected. Review those failures before retrying. Items already resolved elsewhere or no longer available cannot be decided again. **Clear selection** closes the selection; **Dismiss** closes a completed result when nothing remains selected.

Changing search, scope, or filters prunes selected rows outside the new view. During a bulk decision, selection controls are disabled.

## Recover from a refusal

| Message or condition | Recovery |
| - | - |
| Read-only notice | Obtain `knowledge:manage` for the relevant scope if deciding is your responsibility. |
| Item already resolved | Read its current outcome; do not repeat the decision. |
| Artifact outside readable knowledge | Recheck scope and access. The decision changes nothing when authority is refused. |
| Verification occurrence changed | Refresh the item and review the current occurrence before deciding. |
| Artifacts no longer have identical text | Reinspect both; do not force a merge based on old evidence. |
| Artifact changed after the item was raised | Review the new versions before merging. |
| Higher-grade artifact would be merged away | Keep the higher-grade artifact instead, if that is the intended result. |

## Key state to watch

* **The read-only notice** — you lack `knowledge:manage` for the scope.
* **Item already resolved** — read its current outcome rather than repeating the decision.
* **Refused artifacts in a bulk result** — retryable failures stay selected; review them before retrying.

An empty queue describes the current readable, filtered view. It says nothing about review work outside your scope. See [Knowledge health](https://docs.gloo.com/forge/console/knowledge/health.md), [Sources](https://docs.gloo.com/forge/console/knowledge/sources.md), and [Search quality](https://docs.gloo.com/forge/console/knowledge/search-quality.md).

## Related surfaces

* [Knowledge](https://docs.gloo.com/forge/console/knowledge/artifacts): grade, edit and delete an artifact directly.
* [Evidence](https://docs.gloo.com/forge/console/knowledge/evidence.md): the uses and history behind a case's grade.
* [Health](https://docs.gloo.com/forge/console/knowledge/health.md): embeddings, synchronization, quarantine and integrity status.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.