request_approval
Submit AI agent actions for biometric human approval via Face ID. Returns request ID and status, with auto-approval or denial rules for varying risk levels.
Instructions
Request human approval for an AI agent action via Face ID.
Submit any action (email, purchase, booking, contract, data access, social post, system change) for biometric verification by the authorized human. Returns immediately with request ID and initial status — the action may be auto-approved/denied by rules, or pending human review.
Action types: communication, purchase, scheduling, legal, data_access, social, system Risk levels: low, medium, high, critical
Example: Request approval to send an email action_type: "communication" title: "Send quarterly report to john@company.com" risk_level: "low"
Example: Request approval for a $500 purchase action_type: "purchase" title: "Purchase cloud hosting credits" amount: 500.00 risk_level: "medium"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action_type | Yes | Category of the action | |
| title | Yes | Short description shown to the approver | |
| description | No | Detailed description of the action (optional) | |
| risk_level | No | Risk classification (affects UI urgency and rule evaluation) | medium |
| amount | No | Dollar amount, if applicable (e.g., purchases) | |
| recipient | No | Who receives the action (email address, merchant name, etc.) | |
| reversible | No | Whether the action can be undone | |
| metadata | No | Arbitrary key-value pairs for audit trail | |
| expires_in_seconds | No | Seconds until the request auto-expires (default: 5 minutes) | |
| callback_url | No | HTTPS URL to receive webhook when approval status changes (optional) |