Skip to content

allow_agent

Grant a child agent's pending permission-required request.

Use when show_agent reports a task in permission-required state and you want to allow the requested action. Intended for MCP clients without elicitation support; clients with elicitation render a permission dialog and resolve the gate automatically.

NameTypeRequiredDescription
sessionIdstringyesThe Polygraph session ID, or a Polygraph app session URL (/s/<session-id> or /orgs/<org-id>/sessions/<session-id>).
repostringyesRepo name or ID of the child agent holding the permission gate.
scopeenumyesOne of: one-time, session. "one-time" applies to this single request; "session" is remembered for equivalent later requests within the child's session.
reasonstringnoOptional reason for allowing the request.