API Documentation

Complete reference for the APAAI Protocol API - the open standard for auditable autonomous systems.

🎯 Propose Actions

Define autonomous intents that require oversight and approval workflows.

🛡️ Enforce Policies

Require approvals, validations, or constraints before action execution.

📋 Collect Evidence

Log verifiable results and artifacts for complete audit trails.

🔍 Audit Everything

Build comprehensive accountability trails for all autonomous actions.

Quick Start Example

# Install the SDK
pip install traceprotocol

# Basic usage
from trace import Trace

trace = Trace()

# 1. Propose an action
decision = trace.propose(
    type="send_email",
    actor={"kind": "agent", "name": "mail-bot"},
    target="mailto:client@acme.com",
    params={"subject": "Proposal"}
)

# 2. Handle policy requirements
if decision.status == "requires_approval":
    trace.approve(decision.id)

# 3. Record evidence
trace.evidence(decision.id, [
    {"name": "email_sent", "pass": True, "note": "msgId=123"}
])