# AgenticUptime API — Agent-Native Infrastructure Monitoring

The agent-native infrastructure monitoring platform. Agents monitor, diagnose, and fix. Humans just watch the dashboards.

## Authentication
Bearer token: `Authorization: Bearer au_YOUR_API_KEY`
Get your key: `POST /api/agent/signup` (no auth required, instant)

## Agent Session Start (3 calls)
1. `GET /api/tenant/notifications?since=LAST_CHECK_ISO` — what changed since last check
2. `GET /api/dashboard` — full monitoring state in one call
3. `GET /api/tenant/me` — your tenant identity, plan, limits

## Agent Self-Signup (Zero Friction)
`POST /api/agent/signup` with `{ tenantSlug: "my-project" }` — returns API key instantly. No email, no password, no verification.

## Server Monitoring
- `GET /api/servers` — list all monitored servers
- `POST /api/servers` — register new server `{ name, host, port, type, region }`
- `GET /api/servers/:id/health` — server health status
- `POST /api/servers/:id/health-check` — trigger manual health check
- `GET /api/servers/:id/metrics` — metrics history

## Domain-Specific Monitoring (7 types)
- `GET /api/redis`, `/api/mongodb`, `/api/mysql`, `/api/dns`, `/api/web`, `/api/turnstun`, `/api/gfs`
- Each: list servers, health status, domain-specific metrics

## AI Agent System
- `GET /api/agent/status` — agent system health
- `GET /api/agent/anomalies` — detected anomalies
- `GET /api/agent/rca/:anomalyId` — root cause analysis
- `POST /api/agent/remediation/execute` — execute remediation
- `GET /api/agent/remediation/pending` — pending approvals
- `POST /api/agent/remediation/:id/approve` — approve remediation
- `GET /api/agent/baselines/:serverId` — server baselines

## Conductor (h-conductor)
- `GET /api/conductor/status` — conductor system status
- `GET /api/conductor/rounds` — recent analysis rounds
- `GET /api/conductor/contexts/:agentId` — agent persistent memory
- `POST /api/conductor/approve/:roundId/:actionIndex` — approve Tier 2 action

## Metrics & Events
- `GET /api/metrics/cluster` — cluster-wide metrics
- `GET /api/events` — event timeline with filtering
- `GET /api/events/stats` — event statistics

## API Key Management (requires JWT admin auth)
- `POST /api/auth/api-keys` — create API key
- `GET /api/auth/api-keys` — list keys (masked)
- `DELETE /api/auth/api-keys/:keyId` — revoke key

## τAI Support Chat
- WebSocket: `ws://host/ws/tai?dept=dev|devops|bizintel|compliance|helpdesk`
- HTTP: `POST /api/support/message`, `GET /api/support/history`
- 16 domain experts, 5 department experts with action executors

## Pricing (Per Agent Seat)
- 1 Agent: $0/mo (50 monitors, 60s checks)
- 5 Agents: $49/mo (250 monitors, 30s checks, AI agents)
- 20 Agents: $149/mo (1,000 monitors, 15s checks, auto-remediation)
- Enterprise: Custom (unlimited)

## Key Patterns
- API keys: `au_<plan>_<tenant>_<hex>` format
- All requests: `Authorization: Bearer au_...` + `Content-Type: application/json`
- Tenant-scoped: all data isolated per tenant
- 7 service types: Redis, MongoDB, MySQL, DNS, Web, TURN/STUN, GlusterFS
- 4-tier safety: T0 observe, T1 safe-auto, T2 approval, T3 manual