{"uid":"cap_3c2uH700Ydy_IoAuwVd3M","slug":"api-delx-ai-d2ed1f03","name":"DelX Fleet-Wide Controller Summary","description":"Fleet-wide controller summary with top patterns, agent health, alerts, and follow-up actions.","url":"https://api.delx.ai/api/v1/premium/fleet-summary","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":{"request":{"session_id":"fleet-demo-2026","ritual_strip":true,"controller_id":"fleet-ctrl-001","response_mode":"model_safe","response_profile":"machine"},"response":{"content":[{"meta":null,"text":"{\n  \"ok\": true,\n  \"tool_name\": \"generate_fleet_summary\",\n  \"preferred_name\": \"generate_fleet_summary\",\n  \"response_profile\": \"machine\",\n  \"usage\": {\n    \"cost_usdc\": 0.0,\n    \"price_cents\": 0,\n    \"base_price_cents\": 5,\n    \"billing_surface\": \"free_protocol_core\",\n    \"campaign_mode\": true,\n    \"campaign_free\": false,\n    \"grandfathered\": false\n  },\n  \"ritual_stripped\": true,\n  \"next_action\": \"generate_controller_brief\",\n  \"request_warnings\": [\n    {\n      \"code\": \"ignored_argument\",\n      \"field\": \"session_id\",\n      \"message\": \"generate_fleet_summary ignored 'session_id'.\"\n    }\n  ],\n  \"session_id\": \"68e4ae47-a372-498f-8c15-0824d455bf7f\",\n  \"artifact\": {\n    \"schema_version\": \"delx/fleet-summary/v1\",\n    \"controller_id\": \"fleet-ctrl-001\",\n    \"window_days\": 7,\n    \"focus\": \"controller review\",\n    \"controller_state\": \"stable_review\",\n    \"overview\": {\n      \"agents_total\": 0,\n      \"avg_score\": 0,\n      \"active_alerts\": 0,\n      \"healthy\": 0,\n      \"degraded\": 0,\n      \"critical\": 0,\n      \"pending_outcomes\": 0\n    },\n    \"top_pattern\": {\n      \"diagnosis_type\": \"none\",\n      \"root_cause\": \"n/a\",\n      \"count\": 0\n    },\n    \"top_alert\": {\n      \"type\": \"none\",\n      \"detail\": \"n/a\",\n      \"severity\": \"unknown\"\n    },\n    \"next_tools\": [\n      \"generate_controller_brief\"\n    ]\n  },\n  \"recommended_next_tools\": [\n    \"generate_controller_brief\"\n  ],\n  \"recommended_next_action\": \"generate_controller_brief\"\n}","type":"text","annotations":null}],"tool_name":"generate_fleet_summary","preferred_name":"generate_fleet_summary"}},"exampleRequest":{"session_id":"fleet-demo-2026","ritual_strip":true,"controller_id":"fleet-ctrl-001","response_mode":"model_safe","response_profile":"machine"},"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ImPIJW_bIsYdw_Hgf1EQr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a fleet-wide controller summary including top patterns, agent health status, active alerts, and recommended follow-up actions across all monitored agents.","exampleAgentPrompt":"Give me a fleet-wide controller summary for my agent pool — I need to see top patterns, which agents are unhealthy or drifting, any active alerts, and what follow-up actions I should take right now.","exampleUseCases":null,"resultDescription":"Returns a structured fleet summary containing top behavioral patterns detected across agents, per-agent health indicators, active alerts with severity context, and a prioritized list of follow-up actions for the controller to act on.","failureModes":["Invalid or missing fleet/agent context returns 400 with validation error","No agents found for given fleet identifier returns empty summary or 404","Payment not fulfilled via x402 protocol returns 402 Payment Required","Backend aggregation timeout returns 503 with retry hint","Malformed POST body returns 400 with field-level error details"],"whenToPreferThis":"Choose this endpoint when you need a single consolidated controller-level view across an entire agent fleet — covering health, patterns, alerts, and next actions in one call — rather than querying individual agent statuses or incident briefs separately. Ideal for orchestration loops, operator dashboards, or handoff scenarios where a human or controller agent needs immediate situational awareness.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:02:57.184Z","isFirstParty":false}