agent-approve-actions

Approve Actions

Review and resolve pending actions that require human authorization before the gateway will execute them.

Prerequisites

• Authenticated with a valid API key (see agent-auth)
• Pending actions in the queue (created by agents with approval-required tools)

Steps

List pending approvals

epic-agent approve list
# Shows: approval ID, agent, tool, parameters summary, requested at

Inspect an approval request

epic-agent approve get <approval-id>
# Shows: full tool call details, agent context, risk assessment

Approve an action

epic-agent approve allow <approval-id>
# Gateway immediately executes the queued tool call

Approve with a comment

epic-agent approve allow <approval-id> --comment "Approved for production deployment"

Deny an action

epic-agent approve deny <approval-id>
# Gateway rejects the action — agent receives denial reason

Deny with reason

epic-agent approve deny <approval-id> --reason "Insufficient justification for data deletion"

Bulk approve by pattern

epic-agent approve list --tool "read_*" | epic-agent approve allow --stdin
# Approve all read-only operations in one command

Set up auto-approval rules (dashboard)

• Navigate to Dashboard → Approvals → Auto-approve Rules
• Create rules by tool name, agent ID, or parameter pattern
• Example: auto-approve all list_* tools for trusted agent IDs

Approval states

State	Meaning
pending	Waiting for human review
approved	Approved, tool call executed
denied	Denied, tool call rejected
expired	Not resolved within timeout window

Error handling

• Approval already resolved: check state with epic-agent approve get <id>
• Approval expired: the agent will need to re-request the action
• Cannot find approval: verify ID or check if it was auto-approved by a rule