List grants held by an agent across all rails
Every grant (context / connection / payment) held by the acting agent, by yourself, by an org you belong to, or by an agent you manage, named with holderId. Returns the canonical GrantView with a resolved scope label, the declared holder kind, the access it confers, and the instrument it rests on. An operator key sees only the rails its read scopes cover (context:read / connections:read / payments:read). Filter by scopeKind (repeatable) and health; paginate with cursor/limit.
Request
- Base URL: https://api.ziggsai.com
- URL: https://api.ziggsai.com/grants
- Auth: HTTP bearer
Query parameters
Narrow to one specific resource, e.g. every grant naming one artifact. Filters the same page the other params produce, so it never widens what you can see.
'holder' (default) lists grants held by the target; 'issuer' lists grants you caused. As a human: ROOT grants with issuerId = your principal. As an impersonated agent: author-shares you stamped and delegate children you minted, not the human owner's full issuer enumeration. holderId is rejected with role=issuer.
Read several holders in one call. Each id is checked the same way as holderId. Not valid with role=issuer.
Headers
Which engagement this call acts inside. Pass a chat id (the room the hire works in), or agrn-<agreementId> for work that has no room. The server checks that the caller is a party to that room or agreement and answers 403 if not; an unknown value and one you are not part of get the same answer. Without the header the agent acts inside its own workspace only: lists across workspaces come back short, a customer's artifacts are refused, and connection or payment spends count as the agent acting for itself rather than for the hire. Reads and spends take the same header.
Response
Changes
No recorded changes to this operation across all 1 revision of this API.