Every API here is available over the APIs.io API and to AI agents over MCP.
{"openapi":"3.1.0","info":{"title":"AutoGPT Agent Server","summary":"AutoGPT Agent Server","description":"This server is used to execute agents that are created by the AutoGPT system.","version":"0.1"},"paths":{"/api/admin/blocks/cost-estimates":{"get":{"tags":["v2","admin","admin","blocks"],"summary":"Export Block Cost Estimates","description":"Aggregate per-block average credits-per-execution over [start, end].\n\nCapped at ANALYTICS_MAX_DAYS days. Returns only blocks whose current cost\ntype is dynamic (SECOND/ITEMS/COST_USD) — static-cost blocks already\ncharge correctly pre-flight and don't need an estimate override. TOKENS\nis excluded because `compute_token_credits` already supplies a per-model\nfloor at pre-flight; a per-block historical mean would lose that\ngranularity.","operationId":"getV2Export block cost estimates","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO timestamp (inclusive)","title":"Start"},"description":"ISO timestamp (inclusive)"},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO timestamp (inclusive)","title":"End"},"description":"ISO timestamp (inclusive)"},{"name":"min_samples","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Minimum executions per block to include","default":10,"title":"Min Samples"},"description":"Minimum executions per block to include"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockCostEstimatesResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/bot-analytics/command-usage":{"get":{"tags":["v2","admin","bot-analytics"],"summary":"Command Usage Breakdown","operationId":"getV2Command usage breakdown","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/Platform"},{"type":"null"}],"title":"Platform"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BotCommandUsage"},"title":"Response Getv2Command Usage Breakdown"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/bot-analytics/guilds":{"get":{"tags":["v2","admin","bot-analytics"],"summary":"Bot Server Roster","operationId":"getV2Bot server roster","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/Platform"},{"type":"null"}],"title":"Platform"}},{"name":"include_left","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Left"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":500,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BotGuildInfo"},"title":"Response Getv2Bot Server Roster"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/bot-analytics/server-timeseries":{"get":{"tags":["v2","admin","bot-analytics"],"summary":"Bot Server-Count Timeseries (sharding curve)","operationId":"getV2Bot server-count timeseries (sharding curve)","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/Platform"},{"type":"null"}],"title":"Platform"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BotServerCountPoint"},"title":"Response Getv2Bot Server-Count Timeseries (Sharding Curve)"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/bot-analytics/summary":{"get":{"tags":["v2","admin","bot-analytics"],"summary":"Bot Usage Summary","operationId":"getV2Bot usage summary","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/Platform"},{"type":"null"}],"title":"Platform"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotAnalyticsSummary"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/bot-analytics/timeseries":{"get":{"tags":["v2","admin","bot-analytics"],"summary":"Bot Message Timeseries","operationId":"getV2Bot message timeseries","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/Platform"},{"type":"null"}],"title":"Platform"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BotTimeseriesPoint"},"title":"Response Getv2Bot Message Timeseries"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/bot-analytics/top-servers":{"get":{"tags":["v2","admin","bot-analytics"],"summary":"Top Servers by Activity","operationId":"getV2Top servers by activity","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/Platform"},{"type":"null"}],"title":"Platform"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BotServerActivity"},"title":"Response Getv2Top Servers By Activity"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/diagnostics/agents":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"Get Agent Diagnostics","description":"Get diagnostic information about agents.\n\nReturns:\n - agents_with_active_executions: Number of unique agents with running/queued executions\n - timestamp: Current timestamp","operationId":"getV2Get agent diagnostics","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDiagnosticsResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"Get Execution Diagnostics","description":"Get comprehensive diagnostic information about execution status.\n\nReturns all execution metrics including:\n- Current state (running, queued)\n- Orphaned executions (>24h old, likely not in executor)\n- Failure metrics (1h, 24h, rate)\n- Long-running detection (stuck >1h, >24h)\n- Stuck queued detection\n- Throughput metrics (completions/hour)\n- RabbitMQ queue depths","operationId":"getV2Get execution diagnostics","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionDiagnosticsResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions/cleanup-all-orphaned":{"post":{"tags":["v2","admin","diagnostics","admin"],"summary":"Cleanup ALL Orphaned Executions","description":"Cleanup ALL orphaned executions (>24h old) by directly updating DB status.\nOperates on all executions, not just paginated results.\n\nReturns:\n Number of executions cleaned up and success message","operationId":"postV2Cleanup all orphaned executions","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions/cleanup-all-stuck-queued":{"post":{"tags":["v2","admin","diagnostics","admin"],"summary":"Cleanup ALL Stuck Queued Executions","description":"Cleanup ALL stuck queued executions (QUEUED >1h) by updating DB status (admin only).\nOperates on entire dataset, not limited to pagination.\n\nReturns:\n Number of executions cleaned up and success message","operationId":"postV2Cleanup all stuck queued executions","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions/cleanup-orphaned":{"post":{"tags":["v2","admin","diagnostics","admin"],"summary":"Cleanup Orphaned Executions","description":"Cleanup orphaned executions by directly updating DB status (admin only).\nFor executions in DB but not actually running in executor (old/stale records).\n\nArgs:\n request: Contains list of execution_ids to cleanup\n\nReturns:\n Number of executions cleaned up and success message","operationId":"postV2Cleanup orphaned executions","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions/failed":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"List Failed Executions","description":"Get detailed list of failed executions.\n\nArgs:\n limit: Maximum number of executions to return (default 100)\n offset: Number of executions to skip (default 0)\n hours: Number of hours to look back (default 24)\n\nReturns:\n List of failed executions with error details","operationId":"getV2List failed executions","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FailedExecutionsListResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/diagnostics/executions/invalid":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"List Invalid Executions","description":"Get detailed list of executions in invalid states (READ-ONLY).\n\nInvalid states indicate data corruption and require manual investigation:\n- QUEUED but has startedAt (impossible - can't start while queued)\n- RUNNING but no startedAt (impossible - can't run without starting)\n\n⚠️ NO BULK ACTIONS PROVIDED - These need case-by-case investigation.\n\nEach invalid execution likely has a different root cause (crashes, race conditions,\nDB corruption). Investigate the execution history and logs to determine appropriate\naction (manual cleanup, status fix, or leave as-is if system recovered).\n\nArgs:\n limit: Maximum number of executions to return (default 100)\n offset: Number of executions to skip (default 0)\n\nReturns:\n List of invalid state executions with details","operationId":"getV2List invalid executions","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunningExecutionsListResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/diagnostics/executions/long-running":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"List Long-Running Executions","description":"Get detailed list of long-running executions (RUNNING status >24h).\n\nArgs:\n limit: Maximum number of executions to return (default 100)\n offset: Number of executions to skip (default 0)\n\nReturns:\n List of long-running executions with details","operationId":"getV2List long-running executions","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunningExecutionsListResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/diagnostics/executions/orphaned":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"List Orphaned Executions","description":"Get detailed list of orphaned executions (>24h old, likely not in executor).\n\nArgs:\n limit: Maximum number of executions to return (default 100)\n offset: Number of executions to skip (default 0)\n\nReturns:\n List of orphaned executions with details","operationId":"getV2List orphaned executions","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunningExecutionsListResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/diagnostics/executions/requeue":{"post":{"tags":["v2","admin","diagnostics","admin"],"summary":"Requeue Stuck Execution","description":"Requeue a stuck QUEUED execution (admin only).\n\nUses add_graph_execution with existing graph_exec_id to requeue.\n\n⚠️ WARNING: Only use for stuck executions. This will re-execute and may cost credits.\n\nArgs:\n request: Contains execution_id to requeue\n\nReturns:\n Success status and message","operationId":"postV2Requeue stuck execution","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequeueExecutionResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions/requeue-all-stuck":{"post":{"tags":["v2","admin","diagnostics","admin"],"summary":"Requeue ALL Stuck Queued Executions","description":"Requeue ALL stuck queued executions (QUEUED >1h) by publishing to RabbitMQ.\nOperates on all executions, not just paginated results.\n\nUses add_graph_execution with existing graph_exec_id to requeue.\n\n⚠️ WARNING: This will re-execute ALL stuck executions and may cost significant credits.\n\nReturns:\n Number of executions requeued and success message","operationId":"postV2Requeue all stuck queued executions","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequeueExecutionResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions/requeue-bulk":{"post":{"tags":["v2","admin","diagnostics","admin"],"summary":"Requeue Multiple Stuck Executions","description":"Requeue multiple stuck QUEUED executions (admin only).\n\nUses add_graph_execution with existing graph_exec_id to requeue.\n\n⚠️ WARNING: Only use for stuck executions. This will re-execute and may cost credits.\n\nArgs:\n request: Contains list of execution_ids to requeue\n\nReturns:\n Number of executions requeued and success message","operationId":"postV2Requeue multiple stuck executions","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequeueExecutionResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions/running":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"List Running Executions","description":"Get detailed list of running and queued executions (recent, likely active).\n\nArgs:\n limit: Maximum number of executions to return (default 100)\n offset: Number of executions to skip (default 0)\n\nReturns:\n List of running executions with details","operationId":"getV2List running executions","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunningExecutionsListResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/diagnostics/executions/stop":{"post":{"tags":["v2","admin","diagnostics","admin"],"summary":"Stop Single Execution","description":"Stop a single execution (admin only).\n\nUses robust stop_graph_execution which cascades to children and waits for termination.\n\nArgs:\n request: Contains execution_id to stop\n\nReturns:\n Success status and message","operationId":"postV2Stop single execution","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions/stop-all-long-running":{"post":{"tags":["v2","admin","diagnostics","admin"],"summary":"Stop ALL Long-Running Executions","description":"Stop ALL long-running executions (RUNNING >24h) by sending cancel signals (admin only).\nOperates on entire dataset, not limited to pagination.\n\nReturns:\n Number of executions stopped and success message","operationId":"postV2Stop all long-running executions","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions/stop-bulk":{"post":{"tags":["v2","admin","diagnostics","admin"],"summary":"Stop Multiple Executions","description":"Stop multiple active executions (admin only).\n\nUses robust stop_graph_execution which cascades to children and waits for termination.\n\nArgs:\n request: Contains list of execution_ids to stop\n\nReturns:\n Number of executions stopped and success message","operationId":"postV2Stop multiple executions","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopExecutionResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/executions/stuck-queued":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"List Stuck Queued Executions","description":"Get detailed list of stuck queued executions (QUEUED >1h, never started).\n\nArgs:\n limit: Maximum number of executions to return (default 100)\n offset: Number of executions to skip (default 0)\n\nReturns:\n List of stuck queued executions with details","operationId":"getV2List stuck queued executions","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunningExecutionsListResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/diagnostics/schedules":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"Get Schedule Diagnostics","description":"Get comprehensive diagnostic information about schedule health.\n\nReturns schedule metrics including:\n- Total schedules (user vs system)\n- Orphaned schedules by category\n- Upcoming executions","operationId":"getV2Get schedule diagnostics","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleHealthMetrics"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/schedules/all":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"List All User Schedules","description":"Get detailed list of all user schedules (excludes system monitoring jobs).\n\nArgs:\n limit: Maximum number of schedules to return (default 100)\n offset: Number of schedules to skip (default 0)\n\nReturns:\n List of schedules with details","operationId":"getV2List all user schedules","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchedulesListResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/diagnostics/schedules/cleanup-orphaned":{"post":{"tags":["v2","admin","diagnostics","admin"],"summary":"Cleanup Orphaned Schedules","description":"Cleanup orphaned schedules by deleting from scheduler (admin only).\n\nArgs:\n request: Contains list of schedule_ids to delete\n\nReturns:\n Number of schedules deleted and success message","operationId":"postV2Cleanup orphaned schedules","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleCleanupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleCleanupResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/diagnostics/schedules/orphaned":{"get":{"tags":["v2","admin","diagnostics","admin"],"summary":"List Orphaned Schedules","description":"Get detailed list of orphaned schedules with orphan reasons.\n\nReturns:\n List of orphaned schedules categorized by orphan type","operationId":"getV2List orphaned schedules","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrphanedSchedulesListResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"}},"security":[{"HTTPBearerJWT":[]}]}},"/api/admin/memory/{user_id}/communities":{"get":{"tags":["v2","admin","admin","memory"],"summary":"List Communities","description":"Communities in the user's account (AutoPilot) memory graph.","operationId":"getV2ListCommunities","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","description":"User id or 'me'","title":"User Id"},"description":"User id or 'me'"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":500,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityListResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/memory/{user_id}/communities/rebuild":{"post":{"tags":["v2","admin","admin","memory"],"summary":"Rebuild Communities","description":"Fire a community rebuild and return 202 + job_id immediately.\n\nFrontend polls\n``GET /api/admin/memory/{user_id}/communities/rebuild/{job_id}``\nfor progress.","operationId":"postV2RebuildCommunities","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","description":"User id or 'me'","title":"User Id"},"description":"User id or 'me'"},{"name":"force","in":"query","required":false,"schema":{"type":"boolean","description":"Reserved — the fire-and-forget wrapper currently always honours the activity gate. Kept on the signature so the frontend hook doesn't need a contract change when the force flag is threaded through to the wrapper.","default":false,"title":"Force"},"description":"Reserved — the fire-and-forget wrapper currently always honours the activity gate. Kept on the signature so the frontend hook doesn't need a contract change when the force flag is threaded through to the wrapper."}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobTriggerResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/memory/{user_id}/communities/rebuild/{job_id}":{"get":{"tags":["v2","admin","admin","memory"],"summary":"Get Community Rebuild Status","description":"Read the current status of a fire-and-forget community rebuild job.","operationId":"getV2GetCommunityRebuildStatus","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","description":"User id or 'me'","title":"User Id"},"description":"User id or 'me'"},{"name":"job_id","in":"path","required":true,"schema":{"type":"string","description":"Job id returned by the POST","title":"Job Id"},"description":"Job id returned by the POST"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityRebuildJobStatus"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/memory/{user_id}/dream":{"post":{"tags":["v2","admin","admin","memory"],"summary":"Trigger Dream Pass","description":"Fire a dream pass and return 202 + job_id immediately.\n\nFrontend polls ``GET /api/admin/memory/{user_id}/dream/{job_id}``\nfor progress. Runs ONLY the dream pass submitter — for the full\nnightly fan-out use ``POST /{user_id}/nightly``.","operationId":"postV2TriggerDreamPass","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","description":"User id or 'me'","title":"User Id"},"description":"User id or 'me'"}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobTriggerResponse"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/memory/{user_id}/dream/{job_id}":{"get":{"tags":["v2","admin","admin","memory"],"summary":"Get Dream Pass Status","description":"Read the current status of a fire-and-forget dream pass job.","operationId":"getV2GetDreamPassStatus","security":[{"HTTPBearerJWT":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","description":"User id or 'me'","title":"User Id"},"description":"User id or 'me'"},{"name":"job_id","in":"path","required":true,"schema":{"type":"string","description":"Job id returned by the POST","title":"Job Id"},"description":"Job id returned by the POST"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DreamJobStatus"}}}},"401":{"$ref":"#/components/responses/HTTP401NotAuthenticatedError"},"422":{"description"
# --- truncated at 32 KB (598 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/autogpt/refs/heads/main/openapi/autogpt-agent-server-openapi.json