---

刪除專案

deleteProject 突變會永久移除專案及其所有相關數據。

基本範例

mutation {
  deleteProject(id: "{project-id}") {
    success
  }
}

使用變數

mutation DeleteProject($projectId: String!) {
  deleteProject(id: $projectId) {
    success
  }
}

變數：

{
  "projectId": "abc123-project-id"
}

突變參數

參數	類型	必需	描述
id	String!	✅ 是	要刪除的專案的唯一標識符

回應欄位

欄位	類型	描述
success	Boolean!	指示刪除是否成功

所需權限

要刪除專案，您必須擁有：

1. 公司級別訪問權限：OWNER、ADMIN 或 MEMBER 在公司的角色
2. 專案級別訪問權限：OWNER 或 ADMIN 在特定專案中的角色

專案角色權限

專案角色	可以刪除專案
OWNER	✅ 是
ADMIN	✅ 是
MEMBER	❌ 否
CLIENT	❌ 否
COMMENT_ONLY	❌ 否
VIEW_ONLY	❌ 否

刪除過程

當您刪除專案時，Blue 會執行以下步驟：

1. 驗證：確認專案存在並且您有權限刪除它
2. 備份：將專案數據保存到垃圾表中以便潛在恢復（僅供內部使用）
3. 立即刪除：從活動數據庫中移除專案
4. 通知：更新相關系統並通知相關服務
5. 背景清理：異步移除所有相關數據

錯誤回應

專案未找到

{
  "errors": [{
    "message": "Project not found",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

權限不足

{
  "errors": [{
    "message": "You are not authorized to delete this project",
    "extensions": {
      "code": "UNAUTHORIZED"
    }
  }]
}

重要說明

• 刪除是 級聯的 - 所有專案數據都會被移除
• 此過程是 異步的 - 大型專案可能需要時間才能完全清理
• 如果您可能稍後需要該專案，請考慮使用 歸檔 而不是刪除
• 刪除的專案會在內部保存以便恢復，但無法通過 API 訪問