Approval Workflows

When a policy rule requires approval, Faramesh pauses the action and notifies you. You approve or deny from the dashboard, Slack, email, API, or CLI.

From the dashboard

1. Go to Approvals

2. Filter by Pending

3. Open an action and click Approve or Deny

4. Optionally add a reason

No extra setup. Your session handles auth.

From Slack

If your org has Slack connected:

1. When an action needs approval, you get a Slack message

2. Click Approve or Deny in the message

3. The action updates immediately

Ask your org admin to set up Slack in Settings > Notifications.

From email

If email notifications are configured:

1. You receive an email with approve/deny links

2. Click the link to approve or deny

3. The action updates immediately

Ask your org admin to configure email in Settings > Notifications.

From the API

Use the approval token from the action response:

curl -X POST "https://api.faramesh.io/v1/actions/{action_id}/approval" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token": "APPROVAL_TOKEN", "approve": true, "reason": "Approved"}'

curl -X POST "https://api.faramesh.io/v1/actions/{action_id}/approval" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token": "APPROVAL_TOKEN", "approve": true, "reason": "Approved"}'

curl -X POST "https://api.faramesh.io/v1/actions/{action_id}/approval" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token": "APPROVAL_TOKEN", "approve": true, "reason": "Approved"}'

From the CLI

faramesh action approve <action_id> --token <approval_token>
faramesh action deny <action_id> --token

faramesh action approve <action_id> --token <approval_token>
faramesh action deny <action_id> --token

faramesh action approve <action_id> --token <approval_token>
faramesh action deny <action_id> --token

The approval token is in the action response when status is pending_approval. For Slack or email, the token is in the link.