Build on Aegis

Quickstart

Issue a passport from the dashboard, then embed it in your agent.

1. Step 1

   Create an organization and issue an AI Passport from the Passports console.

2. Step 2

   Install the SDK for your runtime:

   pip install aegis-protocol
   # or
   npm install @aegis/sdk

3. Step 3

   Initialize the client with your passport ID and let it sign every outbound request:

   import { AegisAgent } from "@aegis/sdk";
   
   const agent = new AegisAgent({
     passportId: process.env.AEGIS_PASSPORT_ID!,
     privateKeyPem: process.env.AEGIS_PRIVATE_KEY!,
   });
   
   const decision = await agent.verify({
     capabilities: ["read:financial_data"],
     relyingParty: "finance-api",
     riskLevel: "MEDIUM",
   });
   
   if (decision.decision !== "ALLOW") throw new Error(decision.reason);

Verification API

Stateless REST endpoint, P99 under 50ms globally.

POST https://verify.aegisprotocol.dev/v1/verify
Content-Type: application/json

{
  "passport_id": "ap_…",
  "requested_capabilities": ["read:financial_data"],
  "interaction_type": "data_access",
  "risk_level": "MEDIUM",
  "relying_party": "finance-api"
}

→ 200 OK
{
  "decision": "ALLOW",
  "trust_score": 892,
  "trust_tier": "TRUSTED",
  "latency_ms": 23,
  "valid_until": "2026-06-27T18:05:00Z",
  "capability_token": "eyJhbGciOiJFUzI1NiIs.…"
}