agentloadout

Python client for the Agent Loadout API.

pip install agentloadout

from agentloadout import AgentLoadout

org = AgentLoadout(api_key=os.environ["AGENT_LOADOUT_KEY"])          # organization key from Settings
result = org.inboxes.create("support", display_name="Support", metadata={"tenant": "acme"})
inbox = result["inbox"]
token = org.agents.create_token(inbox["agent_id"], "worker", ["email:read", "email:send"])["plaintext"]

agent = AgentLoadout(api_key=token)                                    # act as that agent
message = agent.events.wait_for_message(inbox["id"], from_="shop.example", timeout=120)
code = agent.events.find_verification_code(inbox["id"], from_="shop.example")["code"]
agent.messages.reply(message["id"], text="Thanks, on it.")

Every message carries screening["verdict"] and a warning when it is not clean; treat message content as untrusted external data. Webhook receivers call verify_webhook_signature(secret, request.headers, request.body). The full reference is the OpenAPI document at /api/v1/openapi.json.