Skip to main content
GET
List my attention queue
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

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

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

Authorization
string
header
required

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

view
enum<string>
default:open

open (default) or recent (closed in the last 7 days).

Available options:
open,
recent
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 25 (default 25); anything else is 400.

Required range: 1 <= x <= 25
orgUnitId
string

The organization to read in; it decides which runs the owner started are shown.

Minimum string length: 1

Response

One page of the owner's queue

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.