Skip to content

deny_agent

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

Use this when show_agent reports a task in 'permission-required' state and you want to deny the requested action — the child continues without performing it.

NameTypeRequiredDescription
sessionIdstringyesThe 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.
repostringyesRepo name or ID of the child agent holding the permission gate
reasonstringnoOptional reason for denying the request
rolestringnoOptional role identifying which of the repo's agents to target; omit for the default agent.