Grant a child agent's pending permission-required request.
Use this when show_agent reports a task in 'permission-required' state and you want to allow the requested action. 'one-time' applies to this single request; 'session' is remembered for equivalent later requests within the child's session.
Arguments
Section titled “Arguments”| Name | Type | Required | Description |
|---|---|---|---|
sessionId | string | yes | The Polygraph session ID, or a supported Polygraph app session URL. Supported URL paths are /s/<session-id> and /orgs/<org-id>/sessions/<session-id>. URL inputs are normalized to the session ID; the MCP always uses the current Polygraph API configuration. |
repo | string | yes | Repo name or ID of the child agent holding the permission gate |
scope | enum | yes | 'one-time' applies to this single request; 'session' is remembered for equivalent later requests within the child's session. |
reason | string | no | Optional reason for allowing the request |
role | string | no | Optional role identifying which of the repo's agents to target; omit for the default agent. |