Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypha-docs.plinqx.app/llms.txt

Use this file to discover all available pages before exploring further.

Approval workflows let you require human approval before sensitive tool executions. Configure approval rules in policies to enforce governance.

​
Overview

Approval workflows provide:
  • Security: Require approval for sensitive operations
  • Compliance: Meet regulatory requirements for certain actions
  • Audit Trail: Track who approved what and when
  • Flexibility: Single or multi-approver workflows

​
How Approvals Work

1

Policy Triggers Approval

A policy rule with an approval requirement is triggered during tool execution.
2

Request Created

An approval request is created and assigned to approvers.
3

Notification Sent

Approvers receive email notifications (if configured).
4

Approval Decision

Approvers approve or reject the request.
5

Execution Continues

If approved, tool execution continues. If rejected, execution is blocked.

​
Configuring Approval Rules

Approval rules are configured in Policies:
1

Create or Edit Policy

Navigate to Policies and create or edit a policy.
2

Add Approval Rule

Add an approval rule with:
  • Type: Auto-approve, Single Approver, or Multi-approver
  • Approvers: Select which principals can approve
  • Required Approvals: For multi-approver, how many approvals needed
  • Expiry: How long the request is valid

​
Approval Types

TypeDescription
Auto-approveAutomatically approve (useful for logging)
Single ApproverRequire one approval from any approver
Multi-approverRequire multiple approvals from different approvers

​
Managing Approval Requests

​
Viewing Pending Approvals

1

Navigate to Approvals

Click Approvals in the sidebar (under Governance).
2

View Pending

See all pending approval requests assigned to you.

​
Approving Requests

1

Open Request

Click on an approval request to view details.
2

Review Details

Review:
  • Tool: Which tool is being called
  • Parameters: What parameters are being passed
  • Principal: Who initiated the request
  • Context: Additional context about the request
3

Approve

Click Approve and optionally add a comment.

​
Rejecting Requests

1

Open Request

Click on an approval request.
2

Reject

Click Reject and provide a reason.
Rejected requests block tool execution. The requesting principal will receive an error.

​
External Approvals

For external stakeholders, use token-based approvals:
1

Generate Token

When creating an approval request, generate an external approval token.
2

Share Link

Share the approval link with external approvers.
3

External Decision

External approvers can approve/reject via the link without logging in.
Token-based approvals are useful for stakeholders who don’t have Plinqx accounts.

​
Approval Status

Approval requests have statuses:
StatusDescription
PENDINGAwaiting approval
APPROVEDFully approved, execution can proceed
REJECTEDRejected, execution blocked
EXPIREDApproval window expired

​
Email Notifications

Approvers receive email notifications when:
  • A new approval request is created
  • An approval request is about to expire
  • An approval request is resolved
Configure notification preferences in your account settings to control when you receive approval emails.

​
Approval History

View approval history:
  • All Requests: See all approval requests (pending, approved, rejected)
  • Filter by Status: Filter by approval status
  • Filter by Tool: See approvals for specific tools
  • Filter by Principal: See approvals from specific principals

​
Best Practices

Set Expiry Times

Configure reasonable expiry times to avoid stale requests

Clear Approvers

Assign approvers who will respond promptly

Use Multi-approver

Require multiple approvals for high-risk operations

Review Regularly

Regularly review approval patterns to optimize workflows

​
Next Steps

Configure Policies

Set up approval rules in policies

View Audit Logs

Track approval decisions in audit logs