Skip to main content

langgraph-approval-hub

Python SDK for LangGraph Approval Hub — add human-in-the-loop approval workflows to your LangGraph agents in 3 lines.

Install

pip install langgraph-approval-hub

Usage

from langgraph_approval_hub import request_approval

decision = request_approval(
    hub_url="https://your-hub.vercel.app",
    api_token="your-api-secret-token",
    agent_name="Finance Agent",
    action_description="Process $4,200 refund batch for 12 customers",
    assignee="finance-team",
    assignee_type="team",
)

if decision == "approved":
    process_refunds()

request_approval() blocks until a human approves or rejects via the dashboard, then returns "approved" or "rejected".

Parameters

Parameter Type Required Default Description
hub_url str ✅ — Your Approval Hub URL
api_token str ✅ — Your API_SECRET_TOKEN env var value
agent_name str ✅ — Name shown in the dashboard
action_description str ✅ — Plain-English description of what the agent wants to do
assignee str ✅ — Email address or team name
assignee_type str ✅ — "person" or "team"
agent_reasoning str ❌ None Step-by-step reasoning shown to approver
escalate_to str ❌ None Email to escalate to if timeout exceeded
timeout_minutes int ❌ 60 Minutes before escalation
poll_interval int ❌ 10 Seconds between status polls

Links

Metadata

Release files for langgraph-approval-hub 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for langgraph-approval-hub 0.2.0
File Size Uploaded
langgraph_approval_hub-0.2.0.tar.gz 4.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for langgraph-approval-hub 0.2.0
File Interpreter ABI Platform
langgraph_approval_hub-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.4 kB

Release files / langgraph_approval_hub-0.2.0.tar.gz

Download URL langgraph_approval_hub-0.2.0.tar.gz
Size 4.8 kB
Tags Source
SHA-256 checksum
How to use checksums
33f56319742a10b657b34c5f85e107ddcef5432ee4ef8b9db697e6c5e7188aca
BLAKE2b-256 checksum
How to use checksums
fb6ded79db5eecd3bd8646c15d7d3bbcfcca63067a46ed182aaf44b43da219e8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release files / langgraph_approval_hub-0.2.0-py3-none-any.whl

Download URL langgraph_approval_hub-0.2.0-py3-none-any.whl
Size 4.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
85642f6ad5f2413924e95134156182159ae56c107b2d3037922bc187dbc49d25
BLAKE2b-256 checksum
How to use checksums
1080fc822a85fd2a688fafef2d894b22b2ae93f7027dfc3bf9946ee5e87f7529
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page