HUMANLATCH by VerdictLayer

Developer docs

API-first integration

Put a control point in front of agent execution.

HumanLatch sits at the point where an agent, automation, or device would otherwise act on production infrastructure, customer data, money, or physical equipment.

Implementation flow

Step 1

Define the capability your agent wants to execute.

Step 2

Send the proposal to HumanLatch before execution.

Step 3

Read the route: approved_auto, pending_approval, or blocked.

Step 4

Execute only when the control plane says you can.

Code examples

Copy the pattern, then adapt the runtime.

The integration contract stays stable even when your agent framework, runtime, or infrastructure changes.

Installpip install humanlatch
from humanlatch import HumanLatchClient

hl = HumanLatchClient(
    base_url="https://api.humanlatch.verdictlayer.com",
    api_key="hl_your_key_here",
    workspace_id="your-workspace-id",
)

decision = hl.propose_action(
    action_type="database.delete",
    target="users-table",
    summary="Delete inactive users older than 2 years",
    payload={"older_than_days": 730},
    context={
        "environment": "production",
        "requested_by": "agent:cleanup-bot",
    },
)

if hl.is_approved(decision):
    run_delete()
elif hl.requires_approval(decision):
    final = hl.wait_for_decision(decision["id"], interval_seconds=2.0, timeout_seconds=30.0)
    if hl.is_approved(final):
        run_delete()
else:
    raise RuntimeError(f"Blocked: {decision['status']}")

Best-fit domains

The same proposal pattern works across software and physical systems.

Infrastructure Agents

Example capability

terraform.apply

Require a human before production changes, IAM edits, or high-risk infra operations execute.

Support Automation

Example capability

support.refund.issue

Let bots clear low-risk work while escalating sensitive financial or account changes.

Robotics

Example capability

robot.motion.execute

Pause maintenance-zone movement or hazardous motions until an operator approves.

Manufacturing

Example capability

manufacturing.line.override

Escalate line overrides, quality changes, and safety threshold updates before execution.

Implementation tracks

Common ways to add HumanLatch to an existing system.

GitHub Actions and Terraform

Have CI propose the apply before it runs. HumanLatch returns the verdict, then the workflow either proceeds, waits, or fails closed.

Agent frameworks

Wrap the tool call or executor boundary so every consequential capability goes through the same approval service.

Webhook-based resumes

When a human approves, send the event back to your system to resume execution cleanly.