Agent Passports

A passport is a cryptographic identity for an AI agent. It defines who the agent is, what it's allowed to do, and its spending limits. Every passport gets an Ed25519 keypair and a DID (Decentralized Identifier).

Create Passport

POST/api/passportsJWT

Create a new agent passport with identity, action boundaries, and monetary limits.

Request Body

domainstring*
Your organization's domain (e.g. "yourco.com")
agent_namestring
Name of the agent (e.g. "procurement-bot")
allowed_actionsstring[]
Actions this agent is permitted to perform
denied_actionsstring[]
Explicitly blocked actions (takes priority over allowed)
monetary_limit_per_txnnumber
Max amount per single transaction ($)
monetary_limit_per_daynumber
Max total spend per day ($)
framework_idstring
Optional: "langchain", "autogpt", "crewai"
curl
curl -X POST https://aip.synthexai.tech/api/passports   -H "Authorization: Bearer YOUR_JWT"   -H "Content-Type: application/json"   -d '{
    "domain": "yourco.com",
    "agent_name": "data-reader",
    "allowed_actions": ["read_data", "query_db"],
    "monetary_limit_per_txn": 0,
    "monetary_limit_per_day": 0
  }'

# Response:
# {
#   "agent_id": "did:web:yourco.com:agents:data-reader",
#   "public_key": "MCowBQYDK2VwAyEA...",
#   "status": "created"
# }

List Passports

GET/api/passportsJWT

List all agent passports in your account.

curl
curl https://aip.synthexai.tech/api/passports   -H "Authorization: Bearer YOUR_JWT"

# Response:
# {
#   "agents": [
#     {
#       "id": "did:web:yourco.com:agents:data-reader",
#       "domain": "yourco.com",
#       "name": "data-reader",
#       "status": "active",
#       "trust_score": 0.85,
#       "allowed_actions": ["read_data", "query_db"],
#       "monetary_limit_txn": 0,
#       "revoked": false
#     }
#   ],
#   "total": 1
# }
GET/api/passports/{agent_id}JWT

Get full details for a specific agent, including trust history.

curl
curl "https://aip.synthexai.tech/api/passports/did:web:yourco.com:agents:data-reader"   -H "Authorization: Bearer YOUR_JWT"

# Response includes trust history:
# {
#   "id": "did:web:yourco.com:agents:data-reader",
#   "trust_score": 0.85,
#   "history": {
#     "total_intents": 142,
#     "successful_intents": 138,
#     "violations": 3,
#     "revocations": 0
#   }
# }