---

プロジェクトの削除

deleteProject ミューテーションは、プロジェクトとその関連データをBlueから永久に削除します。

基本的な例

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を介してはアクセスできません