FileRequestsManager
July 28, 2025 ยท View on GitHub
Get file request
Retrieves the information about a file request.
This operation is performed by calling function getFileRequestById.
See the endpoint docs at API Reference.
try await client.fileRequests.getFileRequestById(fileRequestId: fileRequestId)
Arguments
- fileRequestId
String- 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/123thefile_request_idis123. Example: "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
- headers
GetFileRequestByIdHeaders- Headers of getFileRequestById method
Returns
This function returns a value of type FileRequest.
Returns a file request object.
Update file request
Updates a file request. This can be used to activate or deactivate a file request.
This operation is performed by calling function updateFileRequestById.
See the endpoint docs at API Reference.
try await client.fileRequests.updateFileRequestById(fileRequestId: copiedFileRequest.id, requestBody: FileRequestUpdateRequest(title: "updated title", description: "updated description"))
Arguments
- fileRequestId
String- 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/123thefile_request_idis123. Example: "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
- requestBody
FileRequestUpdateRequest- Request body of updateFileRequestById method
- headers
UpdateFileRequestByIdHeaders- Headers of updateFileRequestById method
Returns
This function returns a value of type FileRequest.
Returns the updated file request object.
Delete file request
Deletes a file request permanently.
This operation is performed by calling function deleteFileRequestById.
See the endpoint docs at API Reference.
try await client.fileRequests.deleteFileRequestById(fileRequestId: updatedFileRequest.id)
Arguments
- fileRequestId
String- 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/123thefile_request_idis123. Example: "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
- headers
DeleteFileRequestByIdHeaders- Headers of deleteFileRequestById method
Returns
This function returns a value of type ``.
Returns an empty response when the file request has been successfully deleted.
Copy file request
Copies an existing file request that is already present on one folder, and applies it to another folder.
This operation is performed by calling function createFileRequestCopy.
See the endpoint docs at API Reference.
try await client.fileRequests.createFileRequestCopy(fileRequestId: fileRequestId, requestBody: FileRequestCopyRequest(folder: FileRequestCopyRequestFolderField(id: fileRequest.folder.id, type: FileRequestCopyRequestFolderTypeField.folder)))
Arguments
- fileRequestId
String- 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/123thefile_request_idis123. Example: "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
- requestBody
FileRequestCopyRequest- Request body of createFileRequestCopy method
- headers
CreateFileRequestCopyHeaders- Headers of createFileRequestCopy method
Returns
This function returns a value of type FileRequest.
Returns updated file request object.