Skip to main content
GET
List Trust Fabric attention items
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 hold audit: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 ability is 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 reach approvals:approve sees 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 (canApprove and canReject false).

Parameters

data.coverage says how much of the attention sources the page proved; anything but complete sets meta.partial: true.

Example

The response is { "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

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.

Query Parameters

cursor
string

The previous page's meta.nextCursor. It is bound to the caller and the view; any other value is 400 Invalid cursor.

Minimum string length: 1
limit
integer
default:25

Items per page, 1 to 50 (default 25); anything else is 400.

Required range: 1 <= x <= 50

Response

One page of attention items

data
object
required

One page of attention items, ordered for action, with coverage (how much of the attention sources this page proved; anything but complete sets meta.partial) and counts over the page's items. Continue with meta.nextCursor.

meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.