Skip to main content
GET
Get one recorded Trust Fabric decision
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

Returns one Trust Fabric decision recorded for your credential’s acting organization, in the same shape as a List recorded decisions item.

Who can read a decision

The request names only the decision id. Your credential sets the actor and the organization. Any other query parameter, including orgUnitId, returns 400. A credential with no acting organization receives 403. A decision is returned only when it was recorded or reconciled for exactly your acting organization, has no private fence, and your actor still holds grants:read, policies:read and audit:read there when you make the request. Every other decision returns the same 404 resource_missing: another organization’s, a personal or platform-wide one, a private-chat one, a legacy or unresolved record, and a decision that doesn’t exist. A 404 doesn’t tell you which case applies.

What is returned

data contains decision, causes, remediation and correlation, exactly as described in List recorded decisions. remediation is always { "status": "unavailable", "reason": "not_recorded" }. The correlation IDs identify the recorded dispatch. They don’t grant access to that run or step. With includeDecisionFields=true the item adds the recorded decision fields listed there.

Example

Over MCP, forge_call_operation with operationId getGovernanceEvidence returns the same data and meta as its body. See MCP server.

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.

Path Parameters

decisionId
string
required

The recorded decision's identifier.

Minimum string length: 1

Query Parameters

includeDecisionFields
enum<string>
default:false

With true, each item adds the recorded non-person decision fields: policyId, dispatchSurface, missingPermissionKeys, blockedByGate, heldBy, retryable and evidence.sourceKind. It filters nothing and is not bound to the cursor.

Available options:
true,
false

Response

The recorded decision

data
object
required
meta
object
required