Hermes icon

Hermes

Validate, approve, route, and execute AI-generated actions safely

Action → Create Approval Request

AI-generated

Summary

Create an approval request for a Hermes action, optionally validating and routing it through configured services.

Inputs

  • inputSource — Source of the action JSON; can be 'entireItem', 'manualJson', or 'specificField'.
  • inputFieldName — Field path to locate the action JSON when inputSource is 'specificField'.
  • manualJson — Raw JSON string containing the Hermes action.
  • actionName — Fallback action name if not provided in the input.
  • targetService — Fallback target service (e.g., 'gmail').
  • targetOperation — Fallback operation name (e.g., 'create_draft').
  • payloadJson — Default data payload used when input lacks a data object.
  • requiresApproval — Whether the action should trigger an approval request.
  • approvalStatus — Desired approval status for the action.
  • safetyLevel — Configured safety level for validation.
  • dryRun — Simulate the action without external side effects.
  • approvalReason — Reason for approval when creating a request.
  • advancedOptions — Advanced settings such as allowed actions, blocked actions, timeout, etc.

Output shape

an approval request object (e.g., {"success":true,"status":"created","approval_request_id":"","action":"...","target_service":"..."})

Returned only when an approval request is successfully created; otherwise validation errors or approval‑required messages are returned.

Examples

Example 1: Create approval request using manual JSON

manualJson={"action":"create_email_draft","target_service":"gmail","operation":"create_draft"}, targetService=gmail, targetOperation=create_draft, requiresApproval=true, approvalReason='Review needed'

Example 2: Create approval request from a specific field

inputSource=specificField, inputFieldName=output, targetService=whatsapp, targetOperation=send_message, requiresApproval=false

Links

Discussion