Run Agent

POST /api/v1/agents/run

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 the payments service",
    "context": {
      "service": "payments",
      "environment": "production",
      "severity": "high"
    }
  }'

{
  "investigation_id": "inv_abc123",
  "status": "completed",
  "duration_seconds": 45,
  "result": {
    "summary": "Payment service experiencing elevated latency due to database connection pool exhaustion",
    "root_cause": {
      "description": "RDS connection pool at maximum capacity (100/100 connections)",
      "confidence": 92,
      "evidence": [
        "CloudWatch RDS connections metric at 100%",
        "Application logs show 'connection timeout' errors",
        "Spike correlates with deployment at 14:32 UTC"
      ]
    },
    "timeline": [
      {
        "timestamp": "2024-01-15T14:32:00Z",
        "event": "New deployment rolled out"
      },
      {
        "timestamp": "2024-01-15T14:35:00Z",
        "event": "Connection count started increasing"
      },
      {
        "timestamp": "2024-01-15T14:42:00Z",
        "event": "Connection pool exhausted"
      }
    ],
    "affected_systems": [
      "payments-service",
      "checkout-service",
      "RDS primary"
    ],
    "recommendations": [
      {
        "priority": "high",
        "action": "Increase RDS max_connections parameter"
      },
      {
        "priority": "medium",
        "action": "Review connection pool settings in application config"
      },
      {
        "priority": "low",
        "action": "Consider connection pooler like PgBouncer"
      }
    ]
  },
  "tools_used": [
    "get_cloudwatch_logs",
    "get_cloudwatch_metrics",
    "get_pod_logs",
    "search_github_code"
  ],
  "created_at": "2024-01-15T14:45:00Z"
}

{
  "investigation_id": "inv_abc123",
  "status": "running",
  "poll_url": "/api/v1/agents/status/inv_abc123",
  "created_at": "2024-01-15T14:45:00Z"
}

{
  "error": {
    "code": "invalid_request",
    "message": "agent_name is required"
  }
}

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

{
  "error": {
    "code": "rate_limited",
    "message": "Too many investigation requests",
    "retry_after": 60
  }
}

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": "Full system health check",
    "async": true
  }'

curl -X GET https://api.incidentfox.ai/api/v1/agents/status/inv_abc123 \
  -H "Authorization: Bearer $TEAM_TOKEN"

{
  "context": {
    "service": "payments",
    "environment": "production",
    "namespace": "checkout",
    "severity": "high",
    "related_alert": "alert_xyz789",
    "time_window": "1h",
    "hint": "Check recent deployments"
  }
}

import requests

response = requests.post(
    "https://api.incidentfox.ai/api/v1/agents/run",
    headers={
        "Authorization": f"Bearer {TEAM_TOKEN}",
        "Content-Type": "application/json"
    },
    json={
        "agent_name": "planner",
        "message": "Investigate high latency in payments"
    }
)

result = response.json()
print(f"Root cause: {result['result']['root_cause']['description']}")

const response = await fetch('https://api.incidentfox.ai/api/v1/agents/run', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${TEAM_TOKEN}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    agent_name: 'planner',
    message: 'Investigate high latency in payments'
  })
});

const result = await response.json();
console.log(`Root cause: ${result.result.root_cause.description}`);