Skip to main content
GET
Get the agent access report for a person
Lists which agents used which tools on behalf of personId in a window of at most 30 days, one page at a time, as the Console’s agent access report shows it. Pass continueCursor back as cursor, with the same other parameters, for the next page. isDone is true exactly when continueCursor is null. A scan that can’t move on (a source outage, or a position the source can’t page past) ends as done, and coverage says why; an unavailable page is never proof that nothing more exists. A decision the report could not attribute is skipped, so the next page continues past it. Only a Personal key acting as its owner can read this report. The owner is the reader: each row’s run is checked exactly as for that person in the Console, in the org unit you name with orgUnitId, and the key’s scopes narrow what the owner may read. The key must hold audit:read. An External App, a platform key, an MCP key without a person owner and an agent each get a recorded 403 with personRequired: true, the message “This report is available to a Personal key acting as its owner.” and a decisionId. Each row is one tool call: the agent, its name, the tool, when the agent called it, and the decision and trace ids. Rows leave out the Console’s grant evidence, approval ids and grant ids. limit counts rows, so a page can end partway through a decision. coverage says whether the window was read in full, as on the other governance reports.

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

orgUnitId
string
required

The org unit to read in, as the Console's selected org unit.

Required string length: 1 - 200
personId
string
required

The person the agents acted for.

Required string length: 1 - 200
startAt
integer
required

Window start, epoch milliseconds.

Required range: x >= 0
endAt
integer
required

Window end, epoch milliseconds; after startAt and at most 30 days after it.

Required range: x >= 0
cursor
string

The previous page's continueCursor.

Required string length: 1 - 4000
limit
integer
default:25

Most rows per page (one row per tool call; a page can end partway through a decision).

Required range: 1 <= x <= 50

Response

One page of the report

data
object
required
meta
object
required