AI会話一括削除

GUIDのリストで指定したAI会話を一括削除します。ユーザーは自分が所有する会話のみ削除できます。

必要な権限

MEMBER以上のロールが必要です。

HTTPリクエスト

DELETE /api/sonar/ai/conversations

cURL例

curl -H "Authorization: Bearer <API_KEY>" \
     -d guids="a1b2c3d4-e5f6-7890-abcd-ef1234567890,b2c3d4e5-f6a7-8901-bcde-f23456789012" \
     -X DELETE \
     https://HOSTNAME/api/sonar/ai/conversations

リクエストパラメータ

キー	必須	型	説明	備考
guids	O	文字列リスト	会話GUIDの一覧	複数のGUIDはカンマ(`,`)で区切る

正常応答

{
  "failures": []
}

failures (配列): 削除失敗の一覧(全て成功した場合は空配列)
- guid (文字列): 削除に失敗した会話のGUID
- reason (文字列): 失敗理由

エラー応答

guidsが欠落している場合

HTTPステータスコード 400 応答

{
  "error_code": "null-argument",
  "error_msg": "guids should be not null"
}

guidsの項目がGUID形式でない場合

HTTPステータスコード 500 応答

{
  "error_code": "illegal-argument",
  "error_msg": "Invalid UUID string: ..."
}

権限がない場合

HTTPステータスコード 500 応答

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}