dropbox.paper – Paper

This namespace contains endpoints and data types for managing docs and folders in Dropbox Paper.

class dropbox.paper.AddMember(member=None, permission_level=None)

Bases: dropbox.stone_base.Struct

Variables:
__init__(member=None, permission_level=None)

x.__init__(…) initializes x; see help(type(x)) for signature

member

User which should be added to the Paper doc. Specify only email address or Dropbox account ID.

Return type:sharing.MemberSelector
permission_level

Permission for the user.

Return type:paper.PaperDocPermissionLevel
class dropbox.paper.AddPaperDocUser(doc_id=None, members=None, custom_message=None, quiet=None)

Bases: dropbox.paper.RefPaperDoc

Variables:
__init__(doc_id=None, members=None, custom_message=None, quiet=None)

x.__init__(…) initializes x; see help(type(x)) for signature

custom_message

A personal message that will be emailed to each successfully added member.

Return type:str
members

User which should be added to the Paper doc. Specify only email address or Dropbox account ID.

Return type:list of [paper.AddMember]
quiet

Clients should set this to true if no email message shall be sent to added users.

Return type:bool
class dropbox.paper.AddPaperDocUserMemberResult(member=None, result=None)

Bases: dropbox.stone_base.Struct

Per-member result for dropbox.dropbox.Dropbox.paper_docs_users_add().

Variables:
__init__(member=None, result=None)

x.__init__(…) initializes x; see help(type(x)) for signature

member

One of specified input members.

Return type:sharing.MemberSelector
result

The outcome of the action on this member.

Return type:paper.AddPaperDocUserResult
class dropbox.paper.AddPaperDocUserResult(tag, value=None)

Bases: dropbox.stone_base.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 corresponding get_* method.

Variables:
daily_limit_reached = AddPaperDocUserResult('daily_limit_reached', None)
failed_user_data_retrieval = AddPaperDocUserResult('failed_user_data_retrieval', None)
is_daily_limit_reached()

Check if the union tag is daily_limit_reached.

Return type:bool
is_failed_user_data_retrieval()

Check if the union tag is failed_user_data_retrieval.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
is_permission_already_granted()

Check if the union tag is permission_already_granted.

Return type:bool
is_sharing_outside_team_disabled()

Check if the union tag is sharing_outside_team_disabled.

Return type:bool
is_success()

Check if the union tag is success.

Return type:bool
is_unknown_error()

Check if the union tag is unknown_error.

Return type:bool
is_user_is_owner()

Check if the union tag is user_is_owner.

Return type:bool
other = AddPaperDocUserResult('other', None)
permission_already_granted = AddPaperDocUserResult('permission_already_granted', None)
sharing_outside_team_disabled = AddPaperDocUserResult('sharing_outside_team_disabled', None)
success = AddPaperDocUserResult('success', None)
unknown_error = AddPaperDocUserResult('unknown_error', None)
user_is_owner = AddPaperDocUserResult('user_is_owner', None)
class dropbox.paper.Cursor(value=None, expiration=None)

Bases: dropbox.stone_base.Struct

Variables:
  • paper.Cursor.value – The actual cursor value.
  • paper.Cursor.expiration – Expiration time of value. Some cursors might have expiration time assigned. This is a UTC value after which the cursor is no longer valid and the API starts returning an error. If cursor expires a new one needs to be obtained and pagination needs to be restarted. Some cursors might be short-lived some cursors might be long-lived. This really depends on the sorting type and order, e.g.: 1. on one hand, listing docs created by the user, sorted by the created time ascending will have undefinite expiration because the results cannot change while the iteration is happening. This cursor would be suitable for long term polling. 2. on the other hand, listing docs sorted by the last modified time will have a very short expiration as docs do get modified very often and the modified time can be changed while the iteration is happening thus altering the results.
__init__(value=None, expiration=None)

x.__init__(…) initializes x; see help(type(x)) for signature

expiration

Expiration time of value. Some cursors might have expiration time assigned. This is a UTC value after which the cursor is no longer valid and the API starts returning an error. If cursor expires a new one needs to be obtained and pagination needs to be restarted. Some cursors might be short-lived some cursors might be long-lived. This really depends on the sorting type and order, e.g.: 1. on one hand, listing docs created by the user, sorted by the created time ascending will have undefinite expiration because the results cannot change while the iteration is happening. This cursor would be suitable for long term polling. 2. on the other hand, listing docs sorted by the last modified time will have a very short expiration as docs do get modified very often and the modified time can be changed while the iteration is happening thus altering the results.

Return type:datetime.datetime
value

The actual cursor value.

Return type:str
class dropbox.paper.DocLookupError(tag, value=None)

Bases: dropbox.paper.PaperApiBaseError

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 corresponding get_* method.

Variables:paper.DocLookupError.doc_not_found – The required doc was not found.
doc_not_found = DocLookupError('doc_not_found', None)
is_doc_not_found()

Check if the union tag is doc_not_found.

Return type:bool
class dropbox.paper.DocSubscriptionLevel(tag, value=None)

Bases: dropbox.stone_base.Union

The subscription level of a Paper doc.

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 corresponding get_* method.

Variables:
default = DocSubscriptionLevel('default', None)
every = DocSubscriptionLevel('every', None)
ignore = DocSubscriptionLevel('ignore', None)
is_default()

Check if the union tag is default.

Return type:bool
is_every()

Check if the union tag is every.

Return type:bool
is_ignore()

Check if the union tag is ignore.

Return type:bool
is_no_email()

Check if the union tag is no_email.

Return type:bool
no_email = DocSubscriptionLevel('no_email', None)
class dropbox.paper.ExportFormat(tag, value=None)

Bases: dropbox.stone_base.Union

The desired export format of the Paper doc.

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 corresponding get_* method.

Variables:
html = ExportFormat('html', None)
is_html()

Check if the union tag is html.

Return type:bool
is_markdown()

Check if the union tag is markdown.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
markdown = ExportFormat('markdown', None)
other = ExportFormat('other', None)
class dropbox.paper.Folder(id=None, name=None)

Bases: dropbox.stone_base.Struct

Data structure representing a Paper folder.

Variables:
__init__(id=None, name=None)

x.__init__(…) initializes x; see help(type(x)) for signature

id

Paper folder ID. This ID uniquely identifies the folder.

Return type:str
name

Paper folder name.

Return type:str
class dropbox.paper.FolderSharingPolicyType(tag, value=None)

Bases: dropbox.stone_base.Union

The sharing policy of a Paper folder. Note: The sharing policy of subfolders is inherited from the root folder.

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 corresponding get_* method.

Variables:
invite_only = FolderSharingPolicyType('invite_only', None)
is_invite_only()

Check if the union tag is invite_only.

Return type:bool
is_team()

Check if the union tag is team.

Return type:bool
team = FolderSharingPolicyType('team', None)
class dropbox.paper.FolderSubscriptionLevel(tag, value=None)

Bases: dropbox.stone_base.Union

The subscription level of a Paper folder.

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 corresponding get_* method.

Variables:
activity_only = FolderSubscriptionLevel('activity_only', None)
daily_emails = FolderSubscriptionLevel('daily_emails', None)
is_activity_only()

Check if the union tag is activity_only.

Return type:bool
is_daily_emails()

Check if the union tag is daily_emails.

Return type:bool
is_none()

Check if the union tag is none.

Return type:bool
is_weekly_emails()

Check if the union tag is weekly_emails.

Return type:bool
none = FolderSubscriptionLevel('none', None)
weekly_emails = FolderSubscriptionLevel('weekly_emails', None)
class dropbox.paper.FoldersContainingPaperDoc(folder_sharing_policy_type=None, folders=None)

Bases: dropbox.stone_base.Struct

Metadata about Paper folders containing the specififed Paper doc.

Variables:
__init__(folder_sharing_policy_type=None, folders=None)

x.__init__(…) initializes x; see help(type(x)) for signature

folder_sharing_policy_type

The sharing policy of the folder containing the Paper doc.

Return type:paper.FolderSharingPolicyType
folders

The folder path. If present the first folder is the root folder.

Return type:list of [paper.Folder]
class dropbox.paper.ImportFormat(tag, value=None)

Bases: dropbox.stone_base.Union

The import format of the incoming data.

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 corresponding get_* method.

Variables:
html = ImportFormat('html', None)
is_html()

Check if the union tag is html.

Return type:bool
is_markdown()

Check if the union tag is markdown.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
is_plain_text()

Check if the union tag is plain_text.

Return type:bool
markdown = ImportFormat('markdown', None)
other = ImportFormat('other', None)
plain_text = ImportFormat('plain_text', None)
class dropbox.paper.InviteeInfoWithPermissionLevel(invitee=None, permission_level=None)

Bases: dropbox.stone_base.Struct

Variables:
__init__(invitee=None, permission_level=None)

x.__init__(…) initializes x; see help(type(x)) for signature

invitee

Email address invited to the Paper doc.

Return type:sharing.InviteeInfo
permission_level

Permission level for the invitee.

Return type:paper.PaperDocPermissionLevel
class dropbox.paper.ListDocsCursorError(tag, value=None)

Bases: dropbox.stone_base.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 corresponding get_* method.

classmethod cursor_error(val)

Create an instance of this class set to the cursor_error tag with value val.

Parameters:val (paper.PaperApiCursorError) –
Return type:paper.ListDocsCursorError
get_cursor_error()

Only call this if is_cursor_error() is true.

Return type:paper.PaperApiCursorError
is_cursor_error()

Check if the union tag is cursor_error.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
other = ListDocsCursorError('other', None)
class dropbox.paper.ListPaperDocsArgs(filter_by=None, sort_by=None, sort_order=None, limit=None)

Bases: dropbox.stone_base.Struct

Variables:
__init__(filter_by=None, sort_by=None, sort_order=None, limit=None)

x.__init__(…) initializes x; see help(type(x)) for signature

filter_by

Allows user to specify how the Paper docs should be filtered.

Return type:paper.ListPaperDocsFilterBy
limit

Size limit per batch. The maximum number of docs that can be retrieved per batch is 1000. Higher value results in invalid arguments error.

Return type:int
sort_by

Allows user to specify how the Paper docs should be sorted.

Return type:paper.ListPaperDocsSortBy
sort_order

Allows user to specify the sort order of the result.

Return type:paper.ListPaperDocsSortOrder
class dropbox.paper.ListPaperDocsContinueArgs(cursor=None)

Bases: dropbox.stone_base.Struct

Variables:paper.ListPaperDocsContinueArgs.cursor – The cursor obtained from dropbox.dropbox.Dropbox.paper_docs_list() or dropbox.dropbox.Dropbox.paper_docs_list_continue(). Allows for pagination.
__init__(cursor=None)

x.__init__(…) initializes x; see help(type(x)) for signature

cursor

The cursor obtained from dropbox.dropbox.Dropbox.paper_docs_list() or dropbox.dropbox.Dropbox.paper_docs_list_continue(). Allows for pagination.

Return type:str
class dropbox.paper.ListPaperDocsFilterBy(tag, value=None)

Bases: dropbox.stone_base.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 corresponding get_* method.

Variables:
docs_accessed = ListPaperDocsFilterBy('docs_accessed', None)
docs_created = ListPaperDocsFilterBy('docs_created', None)
is_docs_accessed()

Check if the union tag is docs_accessed.

Return type:bool
is_docs_created()

Check if the union tag is docs_created.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
other = ListPaperDocsFilterBy('other', None)
class dropbox.paper.ListPaperDocsResponse(doc_ids=None, cursor=None, has_more=None)

Bases: dropbox.stone_base.Struct

Variables:
__init__(doc_ids=None, cursor=None, has_more=None)

x.__init__(…) initializes x; see help(type(x)) for signature

cursor

Pass the cursor into dropbox.dropbox.Dropbox.paper_docs_list_continue() to paginate through all files. The cursor preserves all properties as specified in the original call to dropbox.dropbox.Dropbox.paper_docs_list().

Return type:paper.Cursor
doc_ids

The list of Paper doc IDs that can be used to access the given Paper docs or supplied to other API methods. The list is sorted in the order specified by the initial call to dropbox.dropbox.Dropbox.paper_docs_list().

Return type:list of [str]
has_more

Will be set to True if a subsequent call with the provided cursor to dropbox.dropbox.Dropbox.paper_docs_list_continue() returns immediately with some results. If set to False please allow some delay before making another call to dropbox.dropbox.Dropbox.paper_docs_list_continue().

Return type:bool
class dropbox.paper.ListPaperDocsSortBy(tag, value=None)

Bases: dropbox.stone_base.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 corresponding get_* method.

Variables:
accessed = ListPaperDocsSortBy('accessed', None)
created = ListPaperDocsSortBy('created', None)
is_accessed()

Check if the union tag is accessed.

Return type:bool
is_created()

Check if the union tag is created.

Return type:bool
is_modified()

Check if the union tag is modified.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
modified = ListPaperDocsSortBy('modified', None)
other = ListPaperDocsSortBy('other', None)
class dropbox.paper.ListPaperDocsSortOrder(tag, value=None)

Bases: dropbox.stone_base.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 corresponding get_* method.

Variables:
ascending = ListPaperDocsSortOrder('ascending', None)
descending = ListPaperDocsSortOrder('descending', None)
is_ascending()

Check if the union tag is ascending.

Return type:bool
is_descending()

Check if the union tag is descending.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
other = ListPaperDocsSortOrder('other', None)
class dropbox.paper.ListUsersCursorError(tag, value=None)

Bases: dropbox.paper.PaperApiBaseError

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 corresponding get_* method.

Variables:paper.ListUsersCursorError.doc_not_found – The required doc was not found.
classmethod cursor_error(val)

Create an instance of this class set to the cursor_error tag with value val.

Parameters:val (paper.PaperApiCursorError) –
Return type:paper.ListUsersCursorError
doc_not_found = ListUsersCursorError('doc_not_found', None)
get_cursor_error()

Only call this if is_cursor_error() is true.

Return type:paper.PaperApiCursorError
is_cursor_error()

Check if the union tag is cursor_error.

Return type:bool
is_doc_not_found()

Check if the union tag is doc_not_found.

Return type:bool
class dropbox.paper.ListUsersOnFolderArgs(doc_id=None, limit=None)

Bases: dropbox.paper.RefPaperDoc

Variables:paper.ListUsersOnFolderArgs.limit – Size limit per batch. The maximum number of users that can be retrieved per batch is 1000. Higher value results in invalid arguments error.
__init__(doc_id=None, limit=None)

x.__init__(…) initializes x; see help(type(x)) for signature

limit

Size limit per batch. The maximum number of users that can be retrieved per batch is 1000. Higher value results in invalid arguments error.

Return type:int
class dropbox.paper.ListUsersOnFolderContinueArgs(doc_id=None, cursor=None)

Bases: dropbox.paper.RefPaperDoc

Variables:paper.ListUsersOnFolderContinueArgs.cursor – The cursor obtained from dropbox.dropbox.Dropbox.paper_docs_folder_users_list() or dropbox.dropbox.Dropbox.paper_docs_folder_users_list_continue(). Allows for pagination.
__init__(doc_id=None, cursor=None)

x.__init__(…) initializes x; see help(type(x)) for signature

cursor

The cursor obtained from dropbox.dropbox.Dropbox.paper_docs_folder_users_list() or dropbox.dropbox.Dropbox.paper_docs_folder_users_list_continue(). Allows for pagination.

Return type:str
class dropbox.paper.ListUsersOnFolderResponse(invitees=None, users=None, cursor=None, has_more=None)

Bases: dropbox.stone_base.Struct

Variables:
__init__(invitees=None, users=None, cursor=None, has_more=None)

x.__init__(…) initializes x; see help(type(x)) for signature

cursor

Pass the cursor into dropbox.dropbox.Dropbox.paper_docs_folder_users_list_continue() to paginate through all users. The cursor preserves all properties as specified in the original call to dropbox.dropbox.Dropbox.paper_docs_folder_users_list().

Return type:paper.Cursor
has_more

Will be set to True if a subsequent call with the provided cursor to dropbox.dropbox.Dropbox.paper_docs_folder_users_list_continue() returns immediately with some results. If set to False please allow some delay before making another call to dropbox.dropbox.Dropbox.paper_docs_folder_users_list_continue().

Return type:bool
invitees

List of email addresses that are invited on the Paper folder.

Return type:list of [sharing.InviteeInfo]
users

List of users that are invited on the Paper folder.

Return type:list of [sharing.UserInfo]
class dropbox.paper.ListUsersOnPaperDocArgs(doc_id=None, limit=None, filter_by=None)

Bases: dropbox.paper.RefPaperDoc

Variables:
__init__(doc_id=None, limit=None, filter_by=None)

x.__init__(…) initializes x; see help(type(x)) for signature

filter_by

Specify this attribute if you want to obtain users that have already accessed the Paper doc.

Return type:paper.UserOnPaperDocFilter
limit

Size limit per batch. The maximum number of users that can be retrieved per batch is 1000. Higher value results in invalid arguments error.

Return type:int
class dropbox.paper.ListUsersOnPaperDocContinueArgs(doc_id=None, cursor=None)

Bases: dropbox.paper.RefPaperDoc

Variables:paper.ListUsersOnPaperDocContinueArgs.cursor – The cursor obtained from dropbox.dropbox.Dropbox.paper_docs_users_list() or dropbox.dropbox.Dropbox.paper_docs_users_list_continue(). Allows for pagination.
__init__(doc_id=None, cursor=None)

x.__init__(…) initializes x; see help(type(x)) for signature

cursor

The cursor obtained from dropbox.dropbox.Dropbox.paper_docs_users_list() or dropbox.dropbox.Dropbox.paper_docs_users_list_continue(). Allows for pagination.

Return type:str
class dropbox.paper.ListUsersOnPaperDocResponse(invitees=None, users=None, doc_owner=None, cursor=None, has_more=None)

Bases: dropbox.stone_base.Struct

Variables:
__init__(invitees=None, users=None, doc_owner=None, cursor=None, has_more=None)

x.__init__(…) initializes x; see help(type(x)) for signature

cursor

Pass the cursor into dropbox.dropbox.Dropbox.paper_docs_users_list_continue() to paginate through all users. The cursor preserves all properties as specified in the original call to dropbox.dropbox.Dropbox.paper_docs_users_list().

Return type:paper.Cursor
doc_owner

The Paper doc owner. This field is populated on every single response.

Return type:sharing.UserInfo
has_more

Will be set to True if a subsequent call with the provided cursor to dropbox.dropbox.Dropbox.paper_docs_users_list_continue() returns immediately with some results. If set to False please allow some delay before making another call to dropbox.dropbox.Dropbox.paper_docs_users_list_continue().

Return type:bool
invitees

List of email addresses with their respective permission levels that are invited on the Paper doc.

Return type:list of [paper.InviteeInfoWithPermissionLevel]
users

List of users with their respective permission levels that are invited on the Paper folder.

Return type:list of [paper.UserInfoWithPermissionLevel]
class dropbox.paper.PaperApiBaseError(tag, value=None)

Bases: dropbox.stone_base.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 corresponding get_* method.

Variables:paper.PaperApiBaseError.insufficient_permissions – Your account does not have permissions to perform this action.
insufficient_permissions = PaperApiBaseError('insufficient_permissions', None)
is_insufficient_permissions()

Check if the union tag is insufficient_permissions.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
other = PaperApiBaseError('other', None)
class dropbox.paper.PaperApiCursorError(tag, value=None)

Bases: dropbox.stone_base.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 corresponding get_* method.

Variables:
expired_cursor = PaperApiCursorError('expired_cursor', None)
invalid_cursor = PaperApiCursorError('invalid_cursor', None)
is_expired_cursor()

Check if the union tag is expired_cursor.

Return type:bool
is_invalid_cursor()

Check if the union tag is invalid_cursor.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
is_reset()

Check if the union tag is reset.

Return type:bool
is_wrong_user_in_cursor()

Check if the union tag is wrong_user_in_cursor.

Return type:bool
other = PaperApiCursorError('other', None)
reset = PaperApiCursorError('reset', None)
wrong_user_in_cursor = PaperApiCursorError('wrong_user_in_cursor', None)
class dropbox.paper.PaperDocCreateArgs(import_format=None, parent_folder_id=None)

Bases: dropbox.stone_base.Struct

Variables:
__init__(import_format=None, parent_folder_id=None)

x.__init__(…) initializes x; see help(type(x)) for signature

import_format

The format of provided data.

Return type:paper.ImportFormat
parent_folder_id

The Paper folder ID where the Paper document should be created. The API user has to have write access to this folder or error is thrown.

Return type:str
class dropbox.paper.PaperDocCreateError(tag, value=None)

Bases: dropbox.paper.PaperApiBaseError

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 corresponding get_* method.

Variables:
content_malformed = PaperDocCreateError('content_malformed', None)
doc_length_exceeded = PaperDocCreateError('doc_length_exceeded', None)
folder_not_found = PaperDocCreateError('folder_not_found', None)
image_size_exceeded = PaperDocCreateError('image_size_exceeded', None)
is_content_malformed()

Check if the union tag is content_malformed.

Return type:bool
is_doc_length_exceeded()

Check if the union tag is doc_length_exceeded.

Return type:bool
is_folder_not_found()

Check if the union tag is folder_not_found.

Return type:bool
is_image_size_exceeded()

Check if the union tag is image_size_exceeded.

Return type:bool
class dropbox.paper.PaperDocCreateUpdateResult(doc_id=None, revision=None, title=None)

Bases: dropbox.stone_base.Struct

Variables:
__init__(doc_id=None, revision=None, title=None)

x.__init__(…) initializes x; see help(type(x)) for signature

doc_id

Doc ID of the newly created doc.

Return type:str
revision

The Paper doc revision. Simply an ever increasing number.

Return type:int
title

The Paper doc title.

Return type:str
class dropbox.paper.PaperDocExport(doc_id=None, export_format=None)

Bases: dropbox.paper.RefPaperDoc

__init__(doc_id=None, export_format=None)

x.__init__(…) initializes x; see help(type(x)) for signature

export_format
Return type:paper.ExportFormat
class dropbox.paper.PaperDocExportResult(owner=None, title=None, revision=None, mime_type=None)

Bases: dropbox.stone_base.Struct

Variables:
__init__(owner=None, title=None, revision=None, mime_type=None)

x.__init__(…) initializes x; see help(type(x)) for signature

mime_type

MIME type of the export. This corresponds to ExportFormat specified in the request.

Return type:str
owner

The Paper doc owner’s email address.

Return type:str
revision

The Paper doc revision. Simply an ever increasing number.

Return type:int
title

The Paper doc title.

Return type:str
class dropbox.paper.PaperDocPermissionLevel(tag, value=None)

Bases: dropbox.stone_base.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 corresponding get_* method.

Variables:
edit = PaperDocPermissionLevel('edit', None)
is_edit()

Check if the union tag is edit.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
is_view_and_comment()

Check if the union tag is view_and_comment.

Return type:bool
other = PaperDocPermissionLevel('other', None)
view_and_comment = PaperDocPermissionLevel('view_and_comment', None)
class dropbox.paper.PaperDocSharingPolicy(doc_id=None, sharing_policy=None)

Bases: dropbox.paper.RefPaperDoc

Variables:paper.PaperDocSharingPolicy.sharing_policy – The default sharing policy to be set for the Paper doc.
__init__(doc_id=None, sharing_policy=None)

x.__init__(…) initializes x; see help(type(x)) for signature

sharing_policy

The default sharing policy to be set for the Paper doc.

Return type:paper.SharingPolicy
class dropbox.paper.PaperDocUpdateArgs(doc_id=None, doc_update_policy=None, revision=None, import_format=None)

Bases: dropbox.paper.RefPaperDoc

Variables:
__init__(doc_id=None, doc_update_policy=None, revision=None, import_format=None)

x.__init__(…) initializes x; see help(type(x)) for signature

doc_update_policy

The policy used for the current update call.

Return type:paper.PaperDocUpdatePolicy
import_format

The format of provided data.

Return type:paper.ImportFormat
revision

The latest doc revision. This value must match the head revision or an error code will be returned. This is to prevent colliding writes.

Return type:int
class dropbox.paper.PaperDocUpdateError(tag, value=None)

Bases: dropbox.paper.DocLookupError

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 corresponding get_* method.

Variables:
content_malformed = PaperDocUpdateError('content_malformed', None)
doc_archived = PaperDocUpdateError('doc_archived', None)
doc_deleted = PaperDocUpdateError('doc_deleted', None)
doc_length_exceeded = PaperDocUpdateError('doc_length_exceeded', None)
image_size_exceeded = PaperDocUpdateError('image_size_exceeded', None)
is_content_malformed()

Check if the union tag is content_malformed.

Return type:bool
is_doc_archived()

Check if the union tag is doc_archived.

Return type:bool
is_doc_deleted()

Check if the union tag is doc_deleted.

Return type:bool
is_doc_length_exceeded()

Check if the union tag is doc_length_exceeded.

Return type:bool
is_image_size_exceeded()

Check if the union tag is image_size_exceeded.

Return type:bool
is_revision_mismatch()

Check if the union tag is revision_mismatch.

Return type:bool
revision_mismatch = PaperDocUpdateError('revision_mismatch', None)
class dropbox.paper.PaperDocUpdatePolicy(tag, value=None)

Bases: dropbox.stone_base.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 corresponding get_* method.

Variables:
append = PaperDocUpdatePolicy('append', None)
is_append()

Check if the union tag is append.

Return type:bool
is_other()

Check if the union tag is other.

Return type:bool
is_overwrite_all()

Check if the union tag is overwrite_all.

Return type:bool
is_prepend()

Check if the union tag is prepend.

Return type:bool
other = PaperDocUpdatePolicy('other', None)
overwrite_all = PaperDocUpdatePolicy('overwrite_all', None)
prepend = PaperDocUpdatePolicy('prepend', None)
class dropbox.paper.RefPaperDoc(doc_id=None)

Bases: dropbox.stone_base.Struct

Variables:paper.RefPaperDoc.doc_id – The Paper doc ID.
__init__(doc_id=None)

x.__init__(…) initializes x; see help(type(x)) for signature

doc_id

The Paper doc ID.

Return type:str
class dropbox.paper.RemovePaperDocUser(doc_id=None, member=None)

Bases: dropbox.paper.RefPaperDoc

Variables:paper.RemovePaperDocUser.member – User which should be removed from the Paper doc. Specify only email address or Dropbox account ID.
__init__(doc_id=None, member=None)

x.__init__(…) initializes x; see help(type(x)) for signature

member

User which should be removed from the Paper doc. Specify only email address or Dropbox account ID.

Return type:sharing.MemberSelector
class dropbox.paper.SharingPolicy(public_sharing_policy=None, team_sharing_policy=None)

Bases: dropbox.stone_base.Struct

Sharing policy of Paper doc.

Variables:
__init__(public_sharing_policy=None, team_sharing_policy=None)

x.__init__(…) initializes x; see help(type(x)) for signature

public_sharing_policy

This value applies to the non-team members.

Return type:paper.SharingPublicPolicyType
team_sharing_policy

This value applies to the team members only. The value is null for all personal accounts.

Return type:paper.SharingTeamPolicyType
class dropbox.paper.SharingPublicPolicyType(tag, value=None)

Bases: dropbox.paper.SharingTeamPolicyType

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 corresponding get_* method.

Variables:paper.SharingPublicPolicyType.disabled – Value used to indicate that doc sharing is enabled only within team.
disabled = SharingPublicPolicyType('disabled', None)
is_disabled()

Check if the union tag is disabled.

Return type:bool
class dropbox.paper.SharingTeamPolicyType(tag, value=None)

Bases: dropbox.stone_base.Union

The sharing policy type of the Paper doc.

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 corresponding get_* method.

Variables:
invite_only = SharingTeamPolicyType('invite_only', None)
is_invite_only()

Check if the union tag is invite_only.

Return type:bool

Check if the union tag is people_with_link_can_edit.

Return type:bool

Check if the union tag is people_with_link_can_view_and_comment.

Return type:bool
class dropbox.paper.UserInfoWithPermissionLevel(user=None, permission_level=None)

Bases: dropbox.stone_base.Struct

Variables:
__init__(user=None, permission_level=None)

x.__init__(…) initializes x; see help(type(x)) for signature

permission_level

Permission level for the user.

Return type:paper.PaperDocPermissionLevel
user

User shared on the Paper doc.

Return type:sharing.UserInfo
class dropbox.paper.UserOnPaperDocFilter(tag, value=None)

Bases: dropbox.stone_base.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 corresponding get_* method.

Variables:
is_other()

Check if the union tag is other.

Return type:bool
is_shared()

Check if the union tag is shared.

Return type:bool
is_visited()

Check if the union tag is visited.

Return type:bool
other = UserOnPaperDocFilter('other', None)
shared = UserOnPaperDocFilter('shared', None)
visited = UserOnPaperDocFilter('visited', None)