API Keys

Create keys to access the AIP Protocol from your code.

Your API Keys

0 active

Quick Start

Python

import requests

API_KEY = "kya_your_key_here"
BASE    = "https://aip.synthexai.tech/api"

# 1. Create an agent passport
passport = requests.post(f"{BASE}/passports", json={
    "domain": "yourco.com",
    "agent_name": "my-agent",
    "allowed_actions": ["read_data", "send_email"],
    "monetary_limit_per_txn": 100.0
}, headers={"Authorization": f"Bearer {TOKEN}"}).json()

# 2. Verify an intent (X-API-Key auth)
result = requests.post(f"{BASE}/verify", json={
    "agent_id": passport["agent_id"],
    "action": "read_data",
    "target": "did:web:partner.com"
}, headers={"X-API-Key": API_KEY}).json()

print(result["verdict"])  # ALLOW or DENY

cURL

# Verify an agent intent
curl -X POST https://aip.synthexai.tech/api/verify \
  -H "X-API-Key: kya_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "did:web:yourco.com:agents:my-agent",
       "action": "transfer_funds",
       "parameters": {"amount": 45.00}}'

Security tip: Never commit API keys to version control. Use environment variables (KYA_API_KEY) or a secrets manager.