ABAgentBlackBoxv2.0
ProductDocsPricingSecurityPilot program
Sign inGet started
ProductDocsPricingSecurityPilot programSign in
  • Overview
  • Quickstart
  • API reference
  • Integrations
  • Help center

Quickstart

Connect one agent, watch what your rules would decide, then let them decide. About fifteen minutes.

1. Create a workspace

Create a free workspace. You are its owner.

2. Add your agent and give it a key

Under Agents, add your agent and list the tools it may use. Under API keys, create a key for that agent. The key is shown once: store it as a secret, for example in ABB_KEY. A key bound to an agent always acts as that agent.

3. Create a work unit

A work unit is one task your agent is handling, with its own record. Create one under Work units → New and copy its ID from the address bar.

4. Start in watch-only mode

New workspaces start in Watch only mode (see Settings → Protection). Your rules decide and record every action your agent sends, but nothing is blocked. Built-in rules already block deletions, and ask a person before money moves, before data is shared or a message goes outside your organization, and before critical-risk actions.

5. Ask before acting

Before the agent does something, it sends the action to AgentBlackBox:

curl -s -X POST https://agentblackbox.si/api/intercept \
  -H "x-agentblackbox-key: $ABB_KEY" \
  -H "content-type: application/json" \
  -d '{"workUnitId":"<work unit id>","tool":"payments.send",
       "actionCategory":"MONEY","riskLevel":"HIGH","amount":4800}'

The answer names the decision, for example { "decision": "REQUIRE_APPROVAL", "mode": "shadow", ... }.

6. Follow the decision

  • ALLOW: go ahead as asked.
  • MODIFY or REDACT: go ahead only with transformedAction from the answer.
  • REQUIRE_APPROVAL: in enforce mode the answer carries approvalId. Wait until a person decides: poll GET /api/approvals/<approvalId> until its status is APPROVED or DENIED.
  • DENY: do not do it. In enforce mode this answer has HTTP status 403.

7. Record what happened

curl -s -X POST https://agentblackbox.si/api/events \
  -H "x-agentblackbox-key: $ABB_KEY" \
  -H "content-type: application/json" \
  -d '{"workUnitId":"<work unit id>","type":"ACTION_EXECUTED","title":"Paid invoice INV-2207"}'

The event joins the work unit's tamper-evident record. Open the work unit to see its timeline and audit report.

8. Switch to enforce

When the watch-only decisions look right, choose Enforce under Settings → Protection. From then on, blocked actions are refused and approvals are required.

Next: the API reference (rate limits and errors), and integrations to let agents act in Slack, Gmail, Drive, GitHub or Notion through AgentBlackBox.

AgentBlackBox

AgentBlackBox checks what your AI agents try to do against your rules, asks a person before risky actions, and keeps a tamper-evident record of what happened.

AgentBlackBox sees and controls only what your agents send through it or through tools you connect. It does not monitor other AI tools.

Product

  • Overview
  • Product
  • Product tour
  • Pilot program
  • Pricing
  • Documentation

Trust

  • Security
  • Report a vulnerability
  • Privacy
  • Terms
  • Subprocessors

Help

  • Help center
  • Support
  • Contact

© 2026 AgentBlackBox. All rights reserved.