Technical Questions
Technical FAQ for developers integrating with Agent Status.
API & Authentication
How do I authenticate?
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.agentstatus.dev/api/v1/agents
API base URL
https://api.agentstatus.dev/api/v1
Rate limits
- Standard: 100 requests per minute
- Enterprise: Higher limits available
SDKs?
Not yet. REST API is straightforward. Community SDKs welcome!
Validation & Validations
What IPs do validations come from?
Residential IPs worldwide (dynamic, not allowlistable). Use User-Agent matching:
User-Agent: AgentStatus-Validation/1.0 (agentstatus.dev)
Validation timeout?
Default 30 seconds, configurable up to 120 seconds.
Streaming responses?
Agent Status measures TTFB, waits for completion, verifies final content.
Custom evaluation prompts?
Planned for future release. Currently uses standard prompts.
How are verdicts calculated?
- DOWN: <20% reachability
- DEGRADED: <95% reachability OR <80% eval pass OR SLA miss
- UP: ≥95% reachability AND ≥80% eval pass AND SLA pass
Request format?
Auto-detected (OpenAI, Anthropic) or custom template.
Webhooks
What triggers a webhook?
Status changes: UP↔DOWN, UP↔DEGRADED, etc.
Payload format
{
"event_type": "status_change",
"agent_id": "abc123",
"agent_name": "My Agent",
"previous_status": "UP",
"new_status": "DOWN",
"changed_at": "2026-02-25T10:30:00Z"
}
Webhook timeout?
10 seconds. Process asynchronously if needed.
Retries?
Exponential backoff: 30s, 2min, 10min (max 3 retries).
Data & Privacy
Where is data stored?
Application on Heroku (US), database on Supabase (AWS us-east-1), validations distributed globally.
History retention?
| Tier | Retention |
|---|---|
| Free | 7 days |
| Paid | 30 days |
| Enterprise | Custom |
GDPR?
Minimal personal data (alert emails only). DPA available on request.
Data deletion?
Deleting an agent removes all history. Account deletion removes everything.
Integration
Prometheus/Grafana?
Export via API and push to Pushgateway.
PagerDuty?
Yes, via webhooks.
SSO?
Enterprise SSO (SAML, OIDC) planned.
Embed in my app?
Status badge widget and public status API available.