dropbox.file_requests
– File Requests
This namespace contains endpoints and data types for file request operations.
- class dropbox.file_requests.CountFileRequestsError(tag, value=None)
Bases:
GeneralFileRequestsError
There was an error counting the file requests.
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.
- class dropbox.file_requests.CountFileRequestsResult(file_request_count=None)
Bases:
Struct
Result for
dropbox.dropbox_client.Dropbox.file_requests_count()
.- Variables:
file_requests.CountFileRequestsResult.file_request_count – The number file requests owner by this user.
- __init__(file_request_count=None)
- file_request_count
- class dropbox.file_requests.CreateFileRequestArgs(title=None, destination=None, deadline=None, open=None, description=None)
Bases:
Struct
Arguments for
dropbox.dropbox_client.Dropbox.file_requests_create()
.- Variables:
file_requests.CreateFileRequestArgs.title – The title of the file request. Must not be empty.
file_requests.CreateFileRequestArgs.destination – The path of the folder in the Dropbox where uploaded files will be sent. For apps with the app folder permission, this will be relative to the app folder.
file_requests.CreateFileRequestArgs.deadline – The deadline for the file request. Deadlines can only be set by Professional and Business accounts.
file_requests.CreateFileRequestArgs.open – Whether or not the file request should be open. If the file request is closed, it will not accept any file submissions, but it can be opened later.
file_requests.CreateFileRequestArgs.description – A description of the file request.
- __init__(title=None, destination=None, deadline=None, open=None, description=None)
- deadline
- description
- destination
- open
- title
- class dropbox.file_requests.CreateFileRequestError(tag, value=None)
Bases:
FileRequestError
There was an error creating the file request.
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.- Variables:
file_requests.CreateFileRequestError.invalid_location – File requests are not available on the specified folder.
file_requests.CreateFileRequestError.rate_limit – The user has reached the rate limit for creating file requests. The limit is currently 4000 file requests total.
- invalid_location = CreateFileRequestError('invalid_location', None)
- is_invalid_location()
Check if the union tag is
invalid_location
.- Return type:
bool
- is_rate_limit()
Check if the union tag is
rate_limit
.- Return type:
bool
- rate_limit = CreateFileRequestError('rate_limit', None)
- class dropbox.file_requests.DeleteAllClosedFileRequestsError(tag, value=None)
Bases:
FileRequestError
There was an error deleting all closed file requests.
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.
- class dropbox.file_requests.DeleteAllClosedFileRequestsResult(file_requests=None)
Bases:
Struct
Result for
dropbox.dropbox_client.Dropbox.file_requests_delete_all_closed()
.- Variables:
file_requests.DeleteAllClosedFileRequestsResult.file_requests – The file requests deleted for this user.
- __init__(file_requests=None)
- file_requests
- class dropbox.file_requests.DeleteFileRequestArgs(ids=None)
Bases:
Struct
Arguments for
dropbox.dropbox_client.Dropbox.file_requests_delete()
.- Variables:
file_requests.DeleteFileRequestArgs.ids – List IDs of the file requests to delete.
- __init__(ids=None)
- ids
- class dropbox.file_requests.DeleteFileRequestError(tag, value=None)
Bases:
FileRequestError
There was an error deleting these file requests.
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.- Variables:
file_requests.DeleteFileRequestError.file_request_open – One or more file requests currently open.
- file_request_open = DeleteFileRequestError('file_request_open', None)
- is_file_request_open()
Check if the union tag is
file_request_open
.- Return type:
bool
- class dropbox.file_requests.DeleteFileRequestsResult(file_requests=None)
Bases:
Struct
Result for
dropbox.dropbox_client.Dropbox.file_requests_delete()
.- Variables:
file_requests.DeleteFileRequestsResult.file_requests – The file requests deleted by the request.
- __init__(file_requests=None)
- file_requests
- class dropbox.file_requests.FileRequest(id=None, url=None, title=None, created=None, is_open=None, file_count=None, destination=None, deadline=None, description=None)
Bases:
Struct
A file request for receiving files into the user’s Dropbox account.
- Variables:
file_requests.FileRequest.id – The ID of the file request.
file_requests.FileRequest.url – The URL of the file request.
file_requests.FileRequest.title – The title of the file request.
file_requests.FileRequest.destination – The path of the folder in the Dropbox where uploaded files will be sent. This can be None if the destination was removed. For apps with the app folder permission, this will be relative to the app folder.
file_requests.FileRequest.created – When this file request was created.
file_requests.FileRequest.deadline – The deadline for this file request. Only set if the request has a deadline.
file_requests.FileRequest.is_open – Whether or not the file request is open. If the file request is closed, it will not accept any more file submissions.
file_requests.FileRequest.file_count – The number of files this file request has received.
file_requests.FileRequest.description – A description of the file request.
- __init__(id=None, url=None, title=None, created=None, is_open=None, file_count=None, destination=None, deadline=None, description=None)
- created
- deadline
- description
- destination
- file_count
- id
- is_open
- title
- url
- class dropbox.file_requests.FileRequestDeadline(deadline=None, allow_late_uploads=None)
Bases:
Struct
- Variables:
file_requests.FileRequestDeadline.deadline – The deadline for this file request.
file_requests.FileRequestDeadline.allow_late_uploads – If set, allow uploads after the deadline has passed. These uploads will be marked overdue.
- __init__(deadline=None, allow_late_uploads=None)
- allow_late_uploads
- deadline
- class dropbox.file_requests.FileRequestError(tag, value=None)
Bases:
GeneralFileRequestsError
There is an error with the file request.
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.- Variables:
file_requests.FileRequestError.not_found – This file request ID was not found.
file_requests.FileRequestError.not_a_folder – The specified path is not a folder.
file_requests.FileRequestError.app_lacks_access – This file request is not accessible to this app. Apps with the app folder permission can only access file requests in their app folder.
file_requests.FileRequestError.no_permission – This user doesn’t have permission to access or modify this file request.
file_requests.FileRequestError.email_unverified – This user’s email address is not verified. File requests are only available on accounts with a verified email address. Users can verify their email address here.
file_requests.FileRequestError.validation_error – There was an error validating the request. For example, the title was invalid, or there were disallowed characters in the destination path.
- app_lacks_access = FileRequestError('app_lacks_access', None)
- email_unverified = FileRequestError('email_unverified', None)
- is_app_lacks_access()
Check if the union tag is
app_lacks_access
.- Return type:
bool
- is_email_unverified()
Check if the union tag is
email_unverified
.- Return type:
bool
- is_no_permission()
Check if the union tag is
no_permission
.- Return type:
bool
- is_not_a_folder()
Check if the union tag is
not_a_folder
.- Return type:
bool
- is_not_found()
Check if the union tag is
not_found
.- Return type:
bool
- is_validation_error()
Check if the union tag is
validation_error
.- Return type:
bool
- no_permission = FileRequestError('no_permission', None)
- not_a_folder = FileRequestError('not_a_folder', None)
- not_found = FileRequestError('not_found', None)
- validation_error = FileRequestError('validation_error', None)
- class dropbox.file_requests.GeneralFileRequestsError(tag, value=None)
Bases:
Union
There is an error accessing the file requests functionality.
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.- Variables:
file_requests.GeneralFileRequestsError.disabled_for_team – This user’s Dropbox Business team doesn’t allow file requests.
- disabled_for_team = GeneralFileRequestsError('disabled_for_team', None)
- is_disabled_for_team()
Check if the union tag is
disabled_for_team
.- Return type:
bool
- is_other()
Check if the union tag is
other
.- Return type:
bool
- other = GeneralFileRequestsError('other', None)
- class dropbox.file_requests.GetFileRequestArgs(id=None)
Bases:
Struct
Arguments for
dropbox.dropbox_client.Dropbox.file_requests_get()
.- Variables:
file_requests.GetFileRequestArgs.id – The ID of the file request to retrieve.
- __init__(id=None)
- id
- class dropbox.file_requests.GetFileRequestError(tag, value=None)
Bases:
FileRequestError
There was an error retrieving the specified file request.
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.
- class dropbox.file_requests.GracePeriod(tag, value=None)
Bases:
Union
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.- always = GracePeriod('always', None)
- is_always()
Check if the union tag is
always
.- Return type:
bool
- is_one_day()
Check if the union tag is
one_day
.- Return type:
bool
- is_other()
Check if the union tag is
other
.- Return type:
bool
- is_seven_days()
Check if the union tag is
seven_days
.- Return type:
bool
- is_thirty_days()
Check if the union tag is
thirty_days
.- Return type:
bool
- is_two_days()
Check if the union tag is
two_days
.- Return type:
bool
- one_day = GracePeriod('one_day', None)
- other = GracePeriod('other', None)
- seven_days = GracePeriod('seven_days', None)
- thirty_days = GracePeriod('thirty_days', None)
- two_days = GracePeriod('two_days', None)
- class dropbox.file_requests.ListFileRequestsArg(limit=None)
Bases:
Struct
Arguments for
dropbox.dropbox_client.Dropbox.file_requests_list()
.- Variables:
file_requests.ListFileRequestsArg.limit – The maximum number of file requests that should be returned per request.
- __init__(limit=None)
- limit
- class dropbox.file_requests.ListFileRequestsContinueArg(cursor=None)
Bases:
Struct
- Variables:
file_requests.ListFileRequestsContinueArg.cursor – The cursor returned by the previous API call specified in the endpoint description.
- __init__(cursor=None)
- cursor
- class dropbox.file_requests.ListFileRequestsContinueError(tag, value=None)
Bases:
GeneralFileRequestsError
There was an error retrieving the file requests.
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.- Variables:
file_requests.ListFileRequestsContinueError.invalid_cursor – The cursor is invalid.
- invalid_cursor = ListFileRequestsContinueError('invalid_cursor', None)
- is_invalid_cursor()
Check if the union tag is
invalid_cursor
.- Return type:
bool
- class dropbox.file_requests.ListFileRequestsError(tag, value=None)
Bases:
GeneralFileRequestsError
There was an error retrieving the file requests.
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.
- class dropbox.file_requests.ListFileRequestsResult(file_requests=None)
Bases:
Struct
Result for
dropbox.dropbox_client.Dropbox.file_requests_list()
.- Variables:
file_requests.ListFileRequestsResult.file_requests – The file requests owned by this user. Apps with the app folder permission will only see file requests in their app folder.
- __init__(file_requests=None)
- file_requests
- class dropbox.file_requests.ListFileRequestsV2Result(file_requests=None, cursor=None, has_more=None)
Bases:
Struct
Result for
dropbox.dropbox_client.Dropbox.file_requests_list()
anddropbox.dropbox_client.Dropbox.file_requests_list_continue()
.- Variables:
file_requests.ListFileRequestsV2Result.file_requests – The file requests owned by this user. Apps with the app folder permission will only see file requests in their app folder.
file_requests.ListFileRequestsV2Result.cursor – Pass the cursor into
dropbox.dropbox_client.Dropbox.file_requests_list_continue()
to obtain additional file requests.file_requests.ListFileRequestsV2Result.has_more – Is true if there are additional file requests that have not been returned yet. An additional call to :route:list/continue` can retrieve them.
- __init__(file_requests=None, cursor=None, has_more=None)
- cursor
- file_requests
- has_more
- class dropbox.file_requests.UpdateFileRequestArgs(id=None, title=None, destination=None, deadline=None, open=None, description=None)
Bases:
Struct
Arguments for
dropbox.dropbox_client.Dropbox.file_requests_update()
.- Variables:
file_requests.UpdateFileRequestArgs.id – The ID of the file request to update.
file_requests.UpdateFileRequestArgs.title – The new title of the file request. Must not be empty.
file_requests.UpdateFileRequestArgs.destination – The new path of the folder in the Dropbox where uploaded files will be sent. For apps with the app folder permission, this will be relative to the app folder.
file_requests.UpdateFileRequestArgs.deadline – The new deadline for the file request. Deadlines can only be set by Professional and Business accounts.
file_requests.UpdateFileRequestArgs.open – Whether to set this file request as open or closed.
file_requests.UpdateFileRequestArgs.description – The description of the file request.
- __init__(id=None, title=None, destination=None, deadline=None, open=None, description=None)
- deadline
- description
- destination
- id
- open
- title
- class dropbox.file_requests.UpdateFileRequestDeadline(tag, value=None)
Bases:
Union
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.- Variables:
file_requests.UpdateFileRequestDeadline.no_update – Do not change the file request’s deadline.
- :ivar Optional[FileRequestDeadline]
file_requests.UpdateFileRequestDeadline.update: If :val:`null`, the file request’s deadline is cleared.
- get_update()
If None, the file request’s deadline is cleared.
Only call this if
is_update()
is true.- Return type:
- is_no_update()
Check if the union tag is
no_update
.- Return type:
bool
- is_other()
Check if the union tag is
other
.- Return type:
bool
- is_update()
Check if the union tag is
update
.- Return type:
bool
- no_update = UpdateFileRequestDeadline('no_update', None)
- other = UpdateFileRequestDeadline('other', None)
- classmethod update(val)
Create an instance of this class set to the
update
tag with valueval
.- Parameters:
val (FileRequestDeadline) –
- Return type:
- class dropbox.file_requests.UpdateFileRequestError(tag, value=None)
Bases:
FileRequestError
There is an error updating the file request.
This class acts as a tagged union. Only one of the
is_*
methods will return true. To get the associated value of a tag (if one exists), use the correspondingget_*
method.