API REFERENCE

API Reference

Base URL: https://api.agentshield.one/v1

Authentication

All API requests require an API key in the Authorization header:

curl -H "Authorization: Bearer ags_live_..." https://api.agentshield.one/v1/events

API keys are prefixed with ags_live_ and can be created in Settings → API Keys.

Events

POST/v1/eventsAPI Key

Track a single LLM event

curl -X POST https://api.agentshield.one/v1/events \
  -H "Authorization: Bearer ags_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "my-agent",
    "model": "gpt-4o",
    "prompt_tokens": 100,
    "completion_tokens": 50,
    "latency_ms": 1200,
    "session_id": "optional-uuid"
  }'

GET/v1/eventsJWT

List recent events

Agents

GET/v1/agentsJWT

List all agents with stats

GET/v1/agents/{name}JWT

Get a specific agent

Sessions

GET/v1/sessionsJWT

List sessions

GET/v1/sessions/{id}JWT

Get session with step timeline

GET/v1/sessions/{id}/shareJWT

Get or create a shareable link

Analytics

GET/v1/analytics/dailyJWT

Daily cost aggregations

GET/v1/analytics/hourlyJWT

Hourly cost aggregations

Alerts

GET/v1/alertsJWT

List alert rules

POST/v1/alertsJWT

Create an alert rule

DELETE/v1/alerts/{id}JWT

Delete an alert rule

Reports

GET/v1/reportsJWT

List generated PDF reports

POST/v1/reports/generateJWT

Generate a new PDF report

GET/v1/reports/{id}/downloadJWT

Download a report PDF

Rate limits

Rate limits vary by plan. The response includes standard headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 998
X-RateLimit-Reset: 1711234567