Governance
List my attention queue
List my attention queue. Requires a Personal key and permission approvals:read.
GET
/
api
/
v3
/
me
/
attention
List my attention queue
curl --request GET \
--url https://api.forge.gloo.com/api/v3/me/attention \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.forge.gloo.com/api/v3/me/attention"
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/me/attention', 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/me/attention",
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/me/attention"
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/me/attention")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.forge.gloo.com/api/v3/me/attention")
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": "resource_missing",
"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 Personal key owner’s Trust Fabric attention queue, the Console’s Waiting on me:open (the default) is everything that asks or names the owner; recent is what closed in the last
7 days.
What ability means here
Each item’s ability is what this key may do with it now. It is judged on the owner’s grants
narrowed to the key’s scopes, never on the owner’s full grants: a key can approve only a hold it
could release itself (its scopes must carry every permission the hold’s release rule requires), and
a key whose scopes do not reach approvals:approve sees every item view-only. A platform key or an
External App cannot call this route (403, error.personRequired: true).
Parameters
| Parameter | Required | Meaning |
|---|---|---|
view | No | open (default) or recent. |
cursor | No | The previous page’s meta.nextCursor. It is bound to the owner and the view; any other value is 400 Invalid cursor. |
limit | No | Items per page, 1 to 25 (default 25). |
orgUnitId | No | The organization to read in, as the Console’s organization picker selects it: it decides which runs the owner started are shown. An unknown one is 404. Items that ask the owner never depend on it. |
Coverage
data.coverage says how much of the attention sources the page proved. Anything but complete
sets meta.partial: true; read data.coverage.reason. data.counts counts the page’s items.
Example
curl "$FORGE_BASE/api/v2/governance/listMyAttention?view=open&limit=10" \
-H "Authorization: Bearer $FORGE_PERSONAL_KEY"
{ "data": { "items": [ … ], "coverage": { … }, "counts": { … } }, "meta": { "requestId": "…", "hasMore": false, "nextCursor": null, "partial": false } }. The MCP tool
forge_list_my_attention returns the same data and meta.Authorizations
A Personal key (fmcp_…), bound to the person who created it, or an interactive MCP sign-in that resolves to one. Pass as Authorization: Bearer <key>. It acts for that person, under their role grants narrowed by its scopes; an operation that acts for a person admits only this kind.
Query Parameters
Response
One page of the owner's queue
⌘I
List my attention queue
curl --request GET \
--url https://api.forge.gloo.com/api/v3/me/attention \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.forge.gloo.com/api/v3/me/attention"
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/me/attention', 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/me/attention",
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/me/attention"
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/me/attention")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.forge.gloo.com/api/v3/me/attention")
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": "resource_missing",
"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
}
}
