VocalDocscontracts 1.65.0

RevealGrantCreateRequest

Requests a reveal grant (1.57.0), in a Member session only. A Call of another Organization is not found (404). A class the requester's role is denied is refused with validation_failed and the issue class_not_revealable; a grant for vocal_support by a Member who is not an owner is forbidden with the detail owner_required.

An object with 8 fields.

Fields

FieldTypeRequiredDescription
agent_idAgentIdnoOne Agent's Calls, with window_from and window_to; instead of call_ids.
call_idsarray of CallIdnoUp to 20 Calls (a target), each once.
classesarray of ContentLogClassyesThe content classes the grant reveals, each once.
duration_minutesintegernoHow long the grant stays active once active: 60 minutes when absent, at most 240 (targets).
granteeRevealGranteeno
reasonstringyesWhy 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.
window_fromRequestTimestampnoThe start of the window of the Agent scope: Calls created at or after it.
window_toRequestTimestampnoThe end of the window: Calls created before it; at most 24 hours (a target) after window_from.

Used by

The operations whose parameters, request body or responses name this shape directly.