Governance
Report agent access on behalf of a person
Get the agent access report for a person. Requires a Personal key acting as its owner, and permission audit:read.
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
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.

