API 參考總覽

• API 端點目錄：所有前端端點，依資源分組（方法、路徑、認證、請求、回應）。
• 狀態列舉值：前端會渲染的所有狀態字串。
• 錯誤碼對照表：HTTP 狀態碼與 sandbox 錯誤語意。

通則

• Base：{BASE}/private/module/sandbox。
• 認證：TeamSync JWT 或 API key（見 認證）。受限 Sandbox scope key 只能動自己的 run 與 menu/提交。
• 請求 body：extra="forbid"（未知欄位 → 422）。
• 分頁：page_size（ge=1 le=100）、page_token（≤512）。
• 列表：lifecycle 查詢參數（active / retired / all，多數預設 active）。
• 未授權：404（不洩漏存在性）。Kill switch 下的變更：503 sandbox_disabled。
• 提交/輪替類：必帶 Idempotency-Key。

本手冊對照後端 master 撰寫。欄位以後端 schema（src/schemas/sandbox.py）與路由為準。