API Introduction

https://api.incidentfox.ai/api/v1

curl -X GET https://api.incidentfox.ai/api/v1/config/me/effective \
  -H "Authorization: Bearer YOUR_TEAM_TOKEN"

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "request_id": "req_abc123"
  }
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1705318260

curl -X POST https://api.incidentfox.ai/api/v1/agents/run \
  -H "Authorization: Bearer $TEAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "planner",
    "message": "Investigate high latency in payments service"
  }'

curl -X GET https://api.incidentfox.ai/api/v1/config/me/effective \
  -H "Authorization: Bearer $TEAM_TOKEN"

from incidentfox import IncidentFoxClient

client = IncidentFoxClient(token="YOUR_TEAM_TOKEN")

# Trigger investigation
result = client.investigate("High error rate in checkout service")
print(result.summary)
print(result.root_cause)

# Get team config
config = client.config.get_effective()
print(config.mcp_servers)

{
  "webhooks": {
    "investigation_complete": "https://your-app.com/webhooks/incidentfox"
  }
}

{
  "event": "investigation_complete",
  "investigation_id": "inv_abc123",
  "summary": "Root cause identified",
  "root_cause": { ... },
  "recommendations": [ ... ]
}