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
# After triggering verification, search, wait and extract in one call.
result = agent.events.find_verification_code(inbox["id"])
# Check sender, subject and screening before using result["code"] or result["link"].
# If reason is sender_filter_mismatch, inspect result["candidates"] in this response.

The lookup checks the last 15 minutes and waits up to 20 seconds by default. Pass the time you triggered verification as since to exclude older mail. Omit from_ unless the actual sender is known.

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.