Agents
List an agent's procedure grants
List an agent’s procedure grants. Requires permission agents:read.
GET
List an agent's procedure grants
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
GET /api/v2/agents/listProcedureGrants?id=<agentId> lists the procedures granted to, or denied to, one agent, oldest assignment first, as the Console’s agent capability tab lists them.
Authority
You needagents:read at the agent’s home org unit. A missing, PERSONAL, unhomed or unreadable agent is the same 404 resource_missing (Agent not found); an unavailable store is 500. id is required once.
What it returns
Each row is{ procedureId, name, mode, assignedAt }: the procedure’s slug, whether it is a grant or a deny, and when it was assigned. name is the procedure’s active version’s display name (else its highest version’s) where your credential’s scopes reach workflows:read and you hold it at that version’s home; otherwise it is null, as the Console shows the slug. A procedure that no longer exists is not listed.
Paging
The grants come a page at a time, oldest assignment first:limit is 1-200, default 200, and a larger value is 400 too_big. While meta.hasMore is true, pass meta.nextCursor as cursor with the same id; a cursor from another route, another agent or another credential, or altered, is 400. A procedure that no longer exists is left out after the read, so a page may hold fewer than limit while more remain. The list never answers meta.partial.Authorizations
Path Parameters
Query Parameters
Response
List an agent's procedure grants

