RevealGrant
A reveal grant (1.57.0): the classes and Calls it reveals, to whom, for how long, and its decisions. Kept as evidence beside the Audit events of the reads under it.
An object with 20 fields.
Fields
| Field | Type | Required | Description |
|---|---|---|---|
agent_id | AgentId or null | yes | |
approval_required | boolean | yes | True when the profile required a second approver at the request. |
call_ids | array or null | yes | The named Calls; null for an Agent scope. |
classes | array of ContentLogClass | yes | |
created_at | Timestamp | yes | |
decided_at | Timestamp or null | yes | |
decided_by | MemberId or null | yes | The approver or decliner; null under reveal_approval: none. |
duration_minutes | integer | yes | |
expires_at | Timestamp or null | yes | When an active grant ends; for a pending grant, when the request lapses. |
grantee | RevealGrantee | yes | |
id | RevealGrantId | yes | |
object | "reveal_grant" | yes | |
reason | string or null | no | Why the content is needed, for the access review: free text that can quote a caller, stored as a content pair and scrubbed at retention_days. Answered only by GET /v1/reveal-grants/{reveal_grant_id}, an audited content read; null once scrubbed. |
requested_by | MemberId | yes | |
revoked_at | Timestamp or null | yes | |
revoked_by | MemberId or null | yes | |
starts_at | Timestamp or null | yes | When the grant became active; null until then. |
status | RevealGrantStatus | yes | |
window_from | Timestamp or null | yes | |
window_to | Timestamp or null | yes |
Used by
The operations whose parameters, request body or responses name this shape directly.