f9a6a8aafb
- Replace all docker-compose.yml/docker-compose.monitoring.yml references with compose.yaml/compose.monitoring.yaml (modern Compose Spec naming) - Replace all `docker-compose` CLI commands with `docker compose` (plugin syntax) - Update Dockerfile stage descriptions: node:18-alpine → node:20.11-bookworm-slim, built-in node user → explicit nodeapp:1001 non-root user - Update image version references: postgres:14-alpine → postgres:14.12-alpine3.19, redis:7-alpine → redis:7.2-alpine3.19 - Externalize postgres credentials: hardcoded values → POSTGRES_USER/PASSWORD/DB env vars - Externalize Grafana admin password: hardcoded 'agentidp' → GF_ADMIN_PASSWORD env var - Add Docker Compose Variables section to environment-variables.md (POSTGRES_*, GF_ADMIN_PASSWORD) - Update local-development.md Step 3: cp .env.example .env, document POSTGRES_* purpose - Update quick-start.md: cp .env.example .env, use awk/sed for JWT key injection - Update 07-dev-setup.md: remove 'no .env.example' claim, reference cp .env.example - Update docker-compose.yml key file description in 04-codebase-structure.md - Update monitoring overlay launch commands across all docs (compose.yaml + compose.monitoring.yaml) - Update volume names to kebab-case: postgres_data → postgres-data, redis_data → redis-data - Fix compliance encryption-runbook: docker-compose restart agentidp → docker compose restart app All docs now consistent with compose.yaml in repo root. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
SentryAgent.ai AgentIdP — Developer Documentation
The complete documentation for developers building with SentryAgent.ai AgentIdP.
What is this?
SentryAgent.ai AgentIdP is a free, open-source Identity Provider built specifically for AI agents. Your agent gets a unique ID, OAuth 2.0 credentials, and a full audit trail — for free.
Documents
| Document | What it covers |
|---|---|
| Quick Start | Register your first agent and issue a token in under 5 minutes |
| Core Concepts | What AgentIdP is, how it works, and why you need it |
| Guides | Step-by-step walkthroughs for each workflow |
| API Reference | Every endpoint, field, error code, and example |
Guides
| Guide | What it covers |
|---|---|
| Register an Agent | All registration fields, org scoping, validation rules, common errors |
| Manage Credentials | Generate, list, rotate, revoke credentials |
| Issue and Revoke Tokens | OAuth 2.0 client credentials flow, introspect, revoke |
| Query Audit Logs | Filters, pagination, event structure, retention |
| Use the Analytics Dashboard | Query token trends, activity heatmap, per-agent usage |
| Manage API Tiers | Check current tier, understand limits, trigger upgrade |
| A2A Delegation | Create and verify agent-to-agent delegation chains |
| Configure Webhooks | Subscribe to events, delivery guarantees, inspect history |
| AGNTCY Compliance | Export agent cards, generate compliance reports, verify audit chain |
Base URL
http://localhost:3000/api/v1 # local development
All endpoints require a Bearer token in the Authorization header unless noted otherwise.
Free Tier Limits
| Resource | Limit |
|---|---|
| Registered agents | 100 |
| Token requests/month | 10,000 |
| API rate limit | 100 req/min |
| Audit log retention | 90 days |