Python SDK

https://api.clawb.ai/api

pip install clawb-agent-sdk

export CLAWB_BASE_URL="https://api.clawb.ai/api"
export CLAWB_API_KEY="ck_live_replace_me"

from clawb_agent_sdk import ClawbClient

priv_b64, pub_b64 = ClawbClient.generate_ed25519_keypair_b64()
print(pub_b64)

# 1) Register agent (replace public key).
REGISTER_OUT=$(curl -sS -X POST "$CLAWB_BASE_URL/v1/agents/register" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-agent",
    "public_key": "<base64-ed25519-public-key>"
  }')

# 2) Sign challenge bytes locally, then attest with the signature.
curl -sS -X POST "$CLAWB_BASE_URL/v1/agents/attest" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt_01...",
    "challenge_id": "ch_01...",
    "signature": "<base64-ed25519-signature>"
  }'

{
  "agent_id": "agt_01...",
  "challenge_id": "ch_01...",
  "challenge": "<base64-challenge>"
}

curl -sS -X POST "$CLAWB_BASE_URL/v1/telemetry/heartbeat" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Agent-Id: agt_01..." \
  -H "X-Clawb-Timestamp: 1740137855000" \
  -H "X-Clawb-Nonce: n_123" \
  -H "X-Clawb-Signature: <base64-signature>" \
  -d '{"agent_id":"agt_01...","status":"ok","latency_ms":72}'

{
  "ok": true,
  "agent_id": "agt_01...",
  "status": "ok",
  "recorded_at": "2026-02-28T00:00:00Z"
}

curl -sS -X POST "https://api.clawb.ai/api/v1/verify" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Api-Key: ck_live_replace_me" \
  -d '{
    "agent_id": "agt_01...",
    "method": "POST",
    "path": "/v1/refunds",
    "timestamp_ms": 1740137855000,
    "nonce": "2f8d8b19-5e0a-4f8b-b7d4-6dc15b1fe201",
    "body_sha256": "3adfd3eb02f15d4f4b5a9f5b2d18f8d1b6d8a7eac03f4b7a56ec8f8c2f2ff321",
    "signature_b64": "<base64-signature>"
  }'

{
  "valid": true,
  "agent_id": "agt_01...",
  "verified_at": "2026-02-28T00:00:00Z"
}

curl -sS -X POST "$CLAWB_BASE_URL/v1/check" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY" \
  -d '{
    "agent_id": "agt_01...",
    "policy_id": "pol_default",
    "action": "refund",
    "context": {"amount": 49.00, "currency": "USD"}
  }'

{
  "decision": "allow",
  "trace_id": "trc_01abc",
  "reasons": []
}

curl -sS -X POST "$CLAWB_BASE_URL/v1/workspace/agents/upsert" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY" \
  -d '{
    "external_agent_key": "github:app:payments-bot",
    "agent_id": "agt_01...",
    "display_name": "Payments bot",
    "labels": ["prod", "payments"],
    "environment": "prod",
    "source": "provider_api",
    "status": "active"
  }'

curl -sS "$CLAWB_BASE_URL/v1/workspace/agents?environment=prod&label=payments" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY"

{
  "ok": true,
  "count": 1,
  "items": [
    {
      "external_agent_key": "github:app:payments-bot",
      "agent_id": "agt_01...",
      "status": "active"
    }
  ]
}

curl -sS "$CLAWB_BASE_URL/v1/workspace/audit/events?start_ms=1740137000000&end_ms=1740139999000&decision=deny&limit=100" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY"

curl -sS -X POST "$CLAWB_BASE_URL/v1/workspace/audit/export" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY" \
  -d '{
    "format": "csv",
    "filters": {"decision": "deny"},
    "limit": 500
  }'

{
  "ok": true,
  "items": [
    {
      "event_id": "evt_01...",
      "decision": "deny",
      "created_at": "2026-02-28T00:00:00Z"
    }
  ],
  "next_cursor": "cur_01..."
}

MINT_OUT=$(curl -sS -X POST "$CLAWB_BASE_URL/v1/identity/credentials/mint" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY" \
  -d '{
    "agent_id":"agt_01...",
    "provider":"sendgrid",
    "audience":"clawb.provider",
    "ttl_seconds":300,
    "one_time":true,
    "scopes":["email:send"],
    "token_type":"jwt"
  }')

curl -sS -X POST "$CLAWB_BASE_URL/v1/identity/credentials/revoke" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY" \
  -d '{
    "token":"<credential-token>",
    "reason":"cleanup"
  }'

curl -sS -X POST "$CLAWB_BASE_URL/v1/identity/credentials/revoke-by-agent" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY" \
  -d '{
    "agent_id":"agt_01...",
    "reason":"agent reset"
  }'

{
  "ok": true,
  "credential": {
    "cred_id": "crd_01...",
    "token_type": "jwt",
    "expires_at": "2026-02-28T00:05:00Z"
  }
}

curl -sS -X POST "$CLAWB_BASE_URL/v1/identity/kill-switch/minting" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY" \
  -d '{"paused":true,"reason":"incident INC-7"}'

curl -sS -X POST "$CLAWB_BASE_URL/v1/identity/kill-switch/revoke-all" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY" \
  -d '{"reason":"credential compromise"}'

curl -sS "$CLAWB_BASE_URL/v1/identity/kill-switch/status" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY"

{
  "ok": true,
  "minting_paused": true,
  "all_credentials_revoked_at": "2026-02-28T00:00:00Z"
}

curl -sS -X POST "$CLAWB_BASE_URL/v1/reputation/feedback" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Api-Key: $CLAWB_API_KEY" \
  -H "X-Clawb-Feedback-Timestamp: 1740137855000" \
  -H "X-Clawb-Feedback-Nonce: n_123" \
  -H "X-Clawb-Feedback-Signature: <base64-hmac>" \
  -d '{
    "agent_id":"agt_01...",
    "verdict":"bad",
    "evidence":{"reason":"credential_stuffing_pattern"}
  }'

{
  "ok": true,
  "accepted": true,
  "received_at": "2026-02-28T00:00:00Z"
}

curl -sS "$CLAWB_BASE_URL/.well-known/openid-configuration"
curl -sS "$CLAWB_BASE_URL/.well-known/jwks.json"

{
  "issuer": "https://api.clawb.ai/api",
  "jwks_uri": "https://api.clawb.ai/api/.well-known/jwks.json"
}

curl -sS -X POST "https://api.clawb.ai/api/v1/token/exchange" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Agent-Id: agt_01..." \
  -H "X-Clawb-Timestamp: 1740137855000" \
  -H "X-Clawb-Nonce: n_123" \
  -H "X-Clawb-Signature: <base64-signature>" \
  -d '{
    "audience": "aws",
    "policy_id": "pol_default",
    "scopes": ["s3:GetObject"]
  }'

{
  "ok": true,
  "token": "<jwt>",
  "token_type": "Bearer",
  "expires_in": 900
}