ID を指定して、ファイルを完全かつ不可逆的に削除します。
パスパラメーター
| パラメーター | タイプ | 必須 | 説明 |
|---|---|---|---|
|
|
文字列 | はい |
リクエストヘッダー
| ヘッダー | 必須 | 説明 |
|---|---|---|
|
|
はい |
|
リクエスト例
curl -X DELETE "https://api.qoder.com.cn/api/v1/cloud/files/file_019e3bb8e4b67b7789e49ca6ecb2aae0" \
-H "Authorization: Bearer $QODER_PAT"
レスポンス例
HTTP 204 No Content
削除に成功すると、HTTP 204 が返されますが、レスポンス本文はありません。
エラー
| HTTP | タイプ | トリガー |
|---|---|---|
| 401 | – | 認証トークンがない、または無効です |
| 404 |
|
指定した ID のファイルが存在しません |
エラーレスポンス例
{
"error": {
"message": "File 'file_nonexistent123' was not found.",
"type": "not_found_error"
},
"type": "error"
}
注意事項
- この削除は永続的で、元に戻すことはできません。
- 削除後、一覧エンドポイントはそのファイルを返しません。
- ファイルがアクティブなセッションから参照されている場合、削除後にその参照は無効になります。
エラー エンベロープの全体構成については、「エラー」をご参照ください。