最新バージョン
ファイルを削除
APIバージョン 2024.0
ファイルを削除します (完全に削除するか、ごみ箱に移動します)。
項目がBoxから完全に削除されるか、ごみ箱に移動されるかは、会社の設定により決定されます。
レスポンス
none
ファイルが正常に削除された場合は、空のレスポンスを返します。
application/jsonクライアントエラー
Authorizationヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。
application/jsonクライアントエラー
ファイルが見つからないかすでに削除されている場合、またはユーザーにファイルへのアクセス権限が与えられていない場合に返されます。
application/jsonクライアントエラー
file_idが認識されていない形式で指定されている場合に返されます。
application/jsonクライアントエラー
If-Matchヘッダーがファイルの現在のetag値と一致しない場合にエラーを返します。これは、ファイルが前回リクエストされたときから変更されていることを示します。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -i -X DELETE "https://api.box.com/2.0/files/12345" \
-H "authorization: Bearer <ACCESS_TOKEN>"TypeScript Gen
await client.files.deleteFileById(thumbnailFile.id);Python Gen
client.files.delete_file_by_id(thumbnail_file.id).NET Gen
await client.Files.DeleteFileByIdAsync(fileId: thumbnailFile.Id);Java
BoxFile file = new BoxFile(api, "id");
file.delete();Python
client.file(file_id='11111').delete().NET
await client.FilesManager.DeleteAsync(id: "11111");Node
client.files.delete('11111', { etag: '5' })
.then(() => {
// File successfully deleted
})
.catch(err => {
if (err.statusCode === 412) {
// Precondition failed — the file was modified before the deletion was processed
// Read the file again to ensure it is safe to delete and then retry
}
});