{"record":{"id":"ba9cf5d3ba17f05a","repo":"bytedance/deer-flow","slug":"error-fallback-scheduled-task-trigger-failed","errorCode":null,"errorMessage":"{error} (fallback: Scheduled task trigger failed)","messagePattern":"(.+?) \\(fallback: Scheduled task trigger failed\\)","errorType":"http","errorClass":"HTTPException","httpStatus":502,"severity":"error","filePath":"backend/app/gateway/routers/scheduled_tasks.py","lineNumber":268,"sourceCode":"    return updated\n\n\n@router.post(\"/scheduled-tasks/{task_id}/trigger\")\n@require_permission(\"threads\", \"write\")\nasync def trigger_scheduled_task(task_id: str, request: Request):\n    repo = get_scheduled_task_repo(request)\n    service = get_scheduled_task_service(request)\n    user = await get_optional_user_from_request(request)\n    if user is None:\n        raise HTTPException(status_code=401, detail=\"Authentication required\")\n    task = await repo.get(task_id, user_id=str(user.id))\n    if task is None:\n        raise HTTPException(status_code=404, detail=\"Scheduled task not found\")\n    result = await service.dispatch_task(task, now=datetime.now(UTC), trigger=\"manual\")\n    if result[\"outcome\"] == \"conflict\":\n        raise HTTPException(status_code=409, detail=result[\"error\"] or \"Scheduled task trigger conflicted with an active run\")\n    if result[\"outcome\"] == \"failed\":\n        raise HTTPException(status_code=502, detail=result[\"error\"] or \"Scheduled task trigger failed\")\n    return {\"id\": task_id, \"triggered\": True}\n\n\n@router.delete(\"/scheduled-tasks/{task_id}\")\n@require_permission(\"threads\", \"write\")\nasync def delete_scheduled_task(task_id: str, request: Request):\n    repo = get_scheduled_task_repo(request)\n    user = await get_optional_user_from_request(request)\n    if user is None:\n        raise HTTPException(status_code=401, detail=\"Authentication required\")\n    deleted = await repo.delete(task_id, user_id=str(user.id))\n    if not deleted:\n        raise HTTPException(status_code=404, detail=\"Scheduled task not found\")\n    return {\"id\": task_id, \"deleted\": deleted}\n\n\n@router.get(\"/scheduled-tasks/{task_id}/runs\")\n@require_permission(\"threads\", \"read\")","sourceCodeStart":250,"sourceCodeEnd":286,"githubUrl":"https://github.com/bytedance/deer-flow/blob/1dd6ba1acb03700589994b0366c5d1c7d05e2eff/backend/app/gateway/routers/scheduled_tasks.py#L250-L286","documentation":"Error \"{error} (fallback: Scheduled task trigger failed)\" thrown in bytedance/deer-flow.","triggerScenarios":"Thrown at backend/app/gateway/routers/scheduled_tasks.py:268 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check the Gateway logs for the underlying trigger exception and fix the named cause.","Verify the scheduled task's model, thread, and context configuration are valid, then retry."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"1dd6ba1acb03700589994b0366c5d1c7d05e2eff","analyzedAt":"2026-08-14T21:20:34.804Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}