Developer Hub

Build secure AI agents in minutes

SDKs, APIs, and documentation to integrate SoulAuth into your agent infrastructure.

Quickstart

Get up and running in under 60 seconds.

pip install soulauth
soulauth init
soulauth dev  # starts local server with SQLite

Python SDK

Type-safe, async-ready client with built-in caching and automatic key rotation.

  • Full type hints and IDE autocomplete
  • Async/await support
  • Automatic retry with exponential backoff
  • Built-in response caching
  • Zero external dependencies
from soulauth import SoulAuthClient

client = SoulAuthClient(soulkey="sk_live_...")

# Get agent identity
identity = client.whoami()

# Authorize an action
token = client.authorize(action="read", resource="data")

# Check authorization inline
if client.can("write", "config"):
    update_config()

API Endpoints

35+ endpoints across 7 domains. RESTful, JSON-native, SoulKey-authenticated.

Interactive docs

Identity

  • /v1/auth/identity
  • /v1/auth/whoami

Authorization

  • /v1/auth/evaluate

Admin

  • /v1/soulauth/admin/tenants
  • /v1/soulauth/admin/keys
  • /v1/soulauth/admin/policy

Trial

  • /v1/trial/register
  • /v1/trial/verify

Analytics

  • /v1/analytics/anomalies
  • /v1/analytics/baseline
  • /v1/analytics/dashboard

Detection

  • /v1/detection/rules
  • /v1/detection/playbooks
  • /v1/detection/matches

Enforcement

  • /v1/enforcement/quarantine

CLI Reference

12 commands to manage your entire SoulAuth lifecycle from the terminal.

$

soulauth init

Initialize a new SoulAuth project

$

soulauth dev

Start local dev server with SQLite

$

soulauth playground

Interactive policy playground

$

soulauth key issue

Issue a new SoulKey

$

soulauth key list

List all active keys

$

soulauth key rotate

Rotate an existing key

$

soulauth key suspend

Temporarily suspend a key

$

soulauth key revoke

Permanently revoke a key

$

soulauth policy validate

Validate policy files

$

soulauth policy sync

Sync policies from Git

$

soulauth status

Check system health

$

soulauth version

Print version info

Integration Guides

Step-by-step guides for your stack.

Python SDK

Full-featured client library with async support and type hints.

REST API

Direct HTTP integration for any language or framework.

Docker / Kubernetes

Container-ready deployment with Helm charts and K8s manifests.

CI/CD (GitHub Actions)

Automate policy validation and key rotation in your pipeline.

Ready to start building?

Get your API key in under a minute. 14-day Pro trial, no credit card required.

Start Building