Platform API Overview

• Accepts SDK telemetry uploads (POST /api/v1/ingest/)
• Stores runs and actions securely in the cloud
• Provides APIs for querying runs/actions, managing policies, and viewing analytics
• Powers the web console with real-time WebSocket updates

​

Key endpoints

• Auth
  • POST /api/v1/login/access-token
• API keys (recommended for agents)
  • POST /api/v1/api-keys/
• Ingest
  • POST /api/v1/ingest/
• Runs/actions
  • GET /api/v1/runs/
  • GET /api/v1/runs/{run_id}
  • GET /api/v1/runs/{run_id}/actions
• Activity Ledger (audit trail)
  • GET /api/v1/ledger/
  • GET /api/v1/ledger/stats
  • GET /api/v1/ledger/export
• Policies
  • GET /api/v1/policies/
  • GET /api/v1/policies/sync
• Stats
  • GET /api/v1/stats/
  • GET /api/v1/stats/daily
• Replay (analysis/simulation)
  • POST /api/v1/replay/{run_id}
  • GET /api/v1/replay/analysis/{run_id}

​

Authentication

• API keys (recommended for SDK integration) - Generated in the web console
• JWT tokens (for web console access) - Automatic via Clerk authentication

​

Getting started

1. Sign up at console.agentsentinel.dev
2. Generate an API key in Settings → API Keys
3. Use the key in your SDK:
   enable_remote_sync(
       platform_url="https://platform.agentsentinel.dev",
       api_token="as_your_api_key_here"
   )
   

​

OpenAPI specification