Governance
List Trust Fabric attention items
Pages through the operator attention list of the deployment’s organization, as the Forge Console Trust Fabric page shows it, decided at the deployment root. Requires permission audit:read, decided at the deployment root.
GET
/
api
/
v3
/
governance-attention-items
List Trust Fabric attention items
curl --request GET \
--url https://api.forge.gloo.com/api/v3/governance-attention-items \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.forge.gloo.com/api/v3/governance-attention-items"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.forge.gloo.com/api/v3/governance-attention-items', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.forge.gloo.com/api/v3/governance-attention-items",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.forge.gloo.com/api/v3/governance-attention-items"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.forge.gloo.com/api/v3/governance-attention-items")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.forge.gloo.com/api/v3/governance-attention-items")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"items": [
{
"key": "<string>",
"kind": "human_node",
"id": "<string>",
"title": "<string>",
"summary": "<string>",
"requestedAt": 123,
"deadlineAt": 123,
"overdue": true,
"ownerLabel": "<string>",
"workflowRunId": "<string>",
"sessionId": "<string>",
"orgUnitId": "<string>",
"source": "<string>",
"reason": "<string>",
"href": "<string>",
"effect": "resume_workflow",
"resolution": "operator_approval",
"unavailableReason": "<string>",
"form": {
"version": 2,
"schema": {
"type": "object",
"properties": {},
"required": [
"<string>"
],
"xForgeOrder": [
"<string>"
]
},
"actions": [
{
"id": "<string>",
"label": "<string>",
"doneLabel": "<string>",
"style": "primary",
"effect": "permit",
"requires": [
"<string>"
],
"assurance": "none"
}
]
},
"grantDescriptor": {
"targetOrgUnitId": "<string>",
"subjects": [
{
"kind": "worker",
"id": "<string>"
}
],
"targetOrgUnitCode": "<string>",
"connectionTarget": "<string>"
},
"state": "pending",
"subject": {
"kind": "procedure_build",
"label": "<string>",
"href": "<string>",
"requesterLabel": "<string>",
"position": {
"index": 123,
"total": 123
}
},
"effectDetail": {
"toolId": "<string>",
"riskLevel": "read",
"writes": true,
"sendsOut": true,
"credentialUse": true,
"sensitiveData": true,
"egressHosts": [
"<string>"
],
"egressHostsOmitted": 123,
"requiredPermissions": [
"<string>"
]
},
"argsPreview": {
"json": "<string>",
"truncated": true,
"redactedPaths": 123,
"egressHosts": [
"<string>"
]
},
"approvers": {
"names": [
"<string>"
],
"count": 123,
"overflow": true,
"includesMe": true
},
"ability": {
"canApprove": true,
"approveDoor": "operator",
"approveBlockedReason": "<string>",
"canReject": true,
"rejectDoor": "operator",
"rejectBlockedReason": "<string>",
"rejectConsequence": "<string>",
"approveIsSelfRelease": true
},
"decision": {
"decidedAt": 123,
"decidedBy": "<string>",
"decidedByPerson": true,
"reason": "<string>",
"outcome": "build_resumed",
"statusLine": "<string>",
"href": "<string>",
"remaining": 123
},
"cancelReason": "due_date"
}
],
"coverage": {
"status": "complete",
"observedAt": 123,
"snapshotAt": 123,
"examined": 123,
"eligible": 123,
"capped": true,
"reason": "<string>"
},
"counts": {
"visible": 123,
"overdue": 123,
"viewOnly": 123,
"canDecide": 123,
"following": 123
}
},
"meta": {
"requestId": "<string>",
"hasMore": false,
"nextCursor": "<string>",
"partial": true,
"asOf": 123,
"truncated": true
}
}{
"error": {
"code": "bad_request",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "forbidden",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "internal_error",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}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
Pages through the operator attention list — held calls, approvals, human workflow steps and agent setup requests — as the Forge Console Trust Fabric page shows it for the deployment’s organization. Your credential’s grants, narrowed to its scopes, must holdaudit:read at your acting
organization and at the deployment root.
Who reads as whom
- A Personal key reads as its owner, with the owner’s visibility, and each item’s
abilityis judged on the owner’s grants narrowed to the key’s scopes: a key can approve only a hold it could release itself, and a key whose scopes do not reachapprovals:approvesees every item view-only. - A platform key or an External App is no person: it sees the items an operator who is not an
administrator sees, every one of them view-only (
canApproveandcanRejectfalse).
Parameters
| Parameter | Required | Meaning |
|---|---|---|
cursor | No | The previous page’s meta.nextCursor; any other value is 400 Invalid cursor. |
limit | No | Items per page, 1 to 50 (default 25). |
data.coverage says how much of the attention sources the page proved; anything but complete
sets meta.partial: true.
Example
curl "$FORGE_BASE/api/v2/governance/listAttention?limit=25" \
-H "Authorization: Bearer $FORGE_TOKEN"
{ "data": { "items": [ … ], "coverage": { … }, "counts": { … } }, "meta": { "requestId": "…", "hasMore": true, "nextCursor": "…", "partial": true } }. Over MCP,
forge_call_operation with operationId listAttention returns the same data and meta as its body.Authorizations
BearerAuthPlatformApiKeyPersonalKey
Query Parameters
Response
One page of attention items
⌘I
List Trust Fabric attention items
curl --request GET \
--url https://api.forge.gloo.com/api/v3/governance-attention-items \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.forge.gloo.com/api/v3/governance-attention-items"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.forge.gloo.com/api/v3/governance-attention-items', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.forge.gloo.com/api/v3/governance-attention-items",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.forge.gloo.com/api/v3/governance-attention-items"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.forge.gloo.com/api/v3/governance-attention-items")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.forge.gloo.com/api/v3/governance-attention-items")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"items": [
{
"key": "<string>",
"kind": "human_node",
"id": "<string>",
"title": "<string>",
"summary": "<string>",
"requestedAt": 123,
"deadlineAt": 123,
"overdue": true,
"ownerLabel": "<string>",
"workflowRunId": "<string>",
"sessionId": "<string>",
"orgUnitId": "<string>",
"source": "<string>",
"reason": "<string>",
"href": "<string>",
"effect": "resume_workflow",
"resolution": "operator_approval",
"unavailableReason": "<string>",
"form": {
"version": 2,
"schema": {
"type": "object",
"properties": {},
"required": [
"<string>"
],
"xForgeOrder": [
"<string>"
]
},
"actions": [
{
"id": "<string>",
"label": "<string>",
"doneLabel": "<string>",
"style": "primary",
"effect": "permit",
"requires": [
"<string>"
],
"assurance": "none"
}
]
},
"grantDescriptor": {
"targetOrgUnitId": "<string>",
"subjects": [
{
"kind": "worker",
"id": "<string>"
}
],
"targetOrgUnitCode": "<string>",
"connectionTarget": "<string>"
},
"state": "pending",
"subject": {
"kind": "procedure_build",
"label": "<string>",
"href": "<string>",
"requesterLabel": "<string>",
"position": {
"index": 123,
"total": 123
}
},
"effectDetail": {
"toolId": "<string>",
"riskLevel": "read",
"writes": true,
"sendsOut": true,
"credentialUse": true,
"sensitiveData": true,
"egressHosts": [
"<string>"
],
"egressHostsOmitted": 123,
"requiredPermissions": [
"<string>"
]
},
"argsPreview": {
"json": "<string>",
"truncated": true,
"redactedPaths": 123,
"egressHosts": [
"<string>"
]
},
"approvers": {
"names": [
"<string>"
],
"count": 123,
"overflow": true,
"includesMe": true
},
"ability": {
"canApprove": true,
"approveDoor": "operator",
"approveBlockedReason": "<string>",
"canReject": true,
"rejectDoor": "operator",
"rejectBlockedReason": "<string>",
"rejectConsequence": "<string>",
"approveIsSelfRelease": true
},
"decision": {
"decidedAt": 123,
"decidedBy": "<string>",
"decidedByPerson": true,
"reason": "<string>",
"outcome": "build_resumed",
"statusLine": "<string>",
"href": "<string>",
"remaining": 123
},
"cancelReason": "due_date"
}
],
"coverage": {
"status": "complete",
"observedAt": 123,
"snapshotAt": 123,
"examined": 123,
"eligible": 123,
"capped": true,
"reason": "<string>"
},
"counts": {
"visible": 123,
"overdue": 123,
"viewOnly": 123,
"canDecide": 123,
"following": 123
}
},
"meta": {
"requestId": "<string>",
"hasMore": false,
"nextCursor": "<string>",
"partial": true,
"asOf": 123,
"truncated": true
}
}{
"error": {
"code": "bad_request",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "forbidden",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "internal_error",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}
