Decisions
Decisions contains work that needs a business owner or security response. Requests can be created when a policy requires approval or an exception before activity continues, including governed access and tool actions. The Mine view contains requests routed to you. Users with policy-management access can select All to inspect organization-wide governance requests and review records. Each assigned request can include:- Request type, requester, assigned owner, source, creation time, and requested scope.
- The policy or AI system responsible for the request.
- A description of what happened.
- Access evidence or a compact session trace.
- The matched policy and links to the policy, session, or related review.
Verify an approve-once decision
- Send a narrow gateway request that is expected to match the approval policy.
For LLM Gateway traffic, include a stable client-generated
X-Forge-Session-Idvalue. - Confirm the gateway returns
403,X-Forge-Policy-Outcome: approval_required, and anapproval_request_idin the error body. - Open Responses > Decisions, select the matching submitted request, and choose Allow retry once. Add a decision note when your audit policy requires one.
- Confirm the request is Approved and its grant appears as Active.
- Retry the identical gateway request with the same client-generated session
value. Confirm it succeeds with
X-Forge-Policy-Outcome: allowed. - Confirm the grant becomes Used. A later matching invocation should require a new decision.
X-Forge-Session-Id for
observability. Do not send that server-issued value as the client hint on the
retry; reuse the exact value supplied on the original request. See LLM Gateway
session continuity.
Verify a Resource approval
Resource approvals use an exact retry instead of holding a client connection or database transaction:- Send a connection, HTTP request, PostgreSQL or MySQL command, or Redis command that matches a Resource approval policy. Confirm it is not forwarded and the client shows the policy explanation and approval reference.
- Open Responses → Decisions, open that reference, and approve or deny it.
- Approval creates a ten-minute, one-use grant for the exact identity, Resource, protocol operation, and matching policy revisions.
- Retry the identical operation. A valid grant is consumed before forwarding.
- Confirm the decision and grant in Responses and the approval-required attempt plus successful retry in Live → Resources.
Requests
Requests is history, not another reviewer queue. It combines requests visible from the requester or subject perspective:- MCP server or MCP tool access requests.
- Governance approval and exception requests created for controlled activity.
Grants
An approved governance request can create a grant. A grant is the stored authorization that a later policy evaluation can match; it is not a change to the underlying policy. A grant records:- Its originating request, kind, and status.
- Approved scope and match key.
- Policy, user, session, event, or route context when present.
- Resource and exact-operation context when the request came from Resource traffic; the private operation digest is not displayed.
- Source integration and justification.
- Creation and expiration times.
Session controls
Session controls contains interventions associated with agent sessions. The page separates active and cleared controls and shows the session, user, source integration, control mode, reason, status, and last update. Opening a control shows its session and source context, mode, status, and stop reason. Users with organization-management access can clear an active intervention. Clearing records the control as cleared; it does not erase its history.Related records
Responses and Violations are related but not interchangeable:- A Violation records a policy or governance outcome that was configured to create a violation.
- A decision records work requiring a response.
- A grant records authorization created by approval.
- A session control records an intervention applied to a session.