Box Developer Documentation
Log in
Latest version

Delete file request

delete
https://api.box.com/2.0
/file_requests/:file_request_id

This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.

Deletes a file request permanently.

Related Guides

Request

bearer [ACCESS_TOKEN]
application/json

Path Parameters

stringin pathrequired
123

The unique identifier that represent a file request.

The ID for any file request can be determined by visiting a file request builder in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/filerequest/123 the file_request_id is 123.

Response

none

Returns an empty response when the file request has been successfully deleted.

application/jsonClient error

Returned when the access token provided in the Authorization header is not recognized or not provided.

application/jsonClient error

Returned if the file request is not found or has already been deleted, or the user does not have access to the associated folder.

application/jsonClient error

Returned if the file_request_id is not in a recognized format.

application/jsonClient error

An unexpected client error.

delete
Delete file request
You can now try out some of our APIs live, right here in the documentation.
Log in

Request Example

cURL
curl -i -X DELETE "https://api.box.com/2.0/file_requests/42037322" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
TypeScript Gen
await client.fileRequests.deleteFileRequestById(updatedFileRequest.id);
Python Gen
client.file_requests.delete_file_request_by_id(updated_file_request.id)
.NET Gen
await client.FileRequests.DeleteFileRequestByIdAsync(fileRequestId: updatedFileRequest.Id);
Swift Gen (Beta)
try await client.fileRequests.deleteFileRequestById(fileRequestId: updatedFileRequest.id)
Java
BoxFileRequest fileRequest = new BoxFileRequest(api, "id");
fileRequest.delete();
Python
file_request = client.file_request(file_request_id='123456')
file_request.delete()
.NET
bool isSuccess = await client.FileRequestsManager.DeleteFileRequestAsync("12345");
Node
client.fileRequests.delete('2484517969').then(() => console.log('Removed file request'));
iOS
client.fileRequests.delete(fileRequestId: "123456") { result in
    guard case .success = result else {
        print("Error removing file request")
        return
    }

    print("File request removed")
}