flywheel-sdk 21.3.0rc0__py3-none-any.whl → 21.4.0__py3-none-any.whl

flywheel/api/files_api.py

@@ -1,13 +1,6 @@
 # coding: utf-8
 
 """
-    Flywheel
-
-    No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)  # noqa: E501
-
-    OpenAPI spec version: 0.0.1
-    
-    Generated by: https://github.com/swagger-api/swagger-codegen.git
 """
 
 
@@ -37,10 +30,13 @@ class FilesApi(object):
         Add the tags on a file to the list of tags
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param list[str] body: (required)
-        :param bool async_: Perform the request asynchronously
-        :return: list[str]
+        :param file_id:
+        :type file_id: str
+        :param body:
+        :type body: list[str]
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: list[str]
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -64,10 +60,13 @@ class FilesApi(object):
         Add the tags on a file to the list of tags
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param list[str] body: (required)
-        :param bool async_: Perform the request asynchronously
-        :return: list[str]
+        :param file_id:
+        :type file_id: str
+        :param body:
+        :type body: list[str]
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: list[str]
         """
 
         all_params = ['file_id','body',]  # noqa: E501
@@ -146,12 +145,17 @@ class FilesApi(object):
         A user with read-write or higher permissions on the container may delete files that were uploaded by users or were the output of jobs. (Specifically, files whose `origin.type` is either `job` or `user`.) <br/> A user with admin permissions on the container may delete any file.
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version: Version of the file to delete (defaults to current version)
-        :param ContainerDeleteReason delete_reason: A reason for deletion when audit-trail is enabled
-        :param bool force: Force deletion of the file even if some checks fail. Deprecated, will be removed in a future release.
-        :param bool async_: Perform the request asynchronously
-        :return: DeletedResult
+        :param file_id:
+        :type file_id: str
+        :param version: Version of the file to delete (defaults to current version)
+        :type version: int, optional
+        :param delete_reason: A reason for deletion when audit-trail is enabled
+        :type delete_reason: ContainerDeleteReason, optional
+        :param force: Force deletion of the file even if some checks fail. Deprecated, will be removed in a future release., defaults to false
+        :type force: bool, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: DeletedResult
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -175,12 +179,17 @@ class FilesApi(object):
         A user with read-write or higher permissions on the container may delete files that were uploaded by users or were the output of jobs. (Specifically, files whose `origin.type` is either `job` or `user`.) <br/> A user with admin permissions on the container may delete any file.
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version: Version of the file to delete (defaults to current version)
-        :param ContainerDeleteReason delete_reason: A reason for deletion when audit-trail is enabled
-        :param bool force: Force deletion of the file even if some checks fail. Deprecated, will be removed in a future release.
-        :param bool async_: Perform the request asynchronously
-        :return: DeletedResult
+        :param file_id:
+        :type file_id: str
+        :param version: Version of the file to delete (defaults to current version)
+        :type version: int, optional
+        :param delete_reason: A reason for deletion when audit-trail is enabled
+        :type delete_reason: ContainerDeleteReason, optional
+        :param force: Force deletion of the file even if some checks fail. Deprecated, will be removed in a future release., defaults to false
+        :type force: bool, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: DeletedResult
         """
 
         all_params = ['file_id','version','delete_reason','force',]  # noqa: E501
@@ -255,10 +264,13 @@ class FilesApi(object):
         Remove the specified tags from most recent file version
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param list[str] body: List of application-specific tags
-        :param bool async_: Perform the request asynchronously
-        :return: None
+        :param file_id:
+        :type file_id: str
+        :param body: List of application-specific tags
+        :type body: list[str], optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: None
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -282,10 +294,13 @@ class FilesApi(object):
         Remove the specified tags from most recent file version
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param list[str] body: List of application-specific tags
-        :param bool async_: Perform the request asynchronously
-        :return: None
+        :param file_id:
+        :type file_id: str
+        :param body: List of application-specific tags
+        :type body: list[str], optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: None
         """
 
         all_params = ['file_id','body',]  # noqa: E501
@@ -360,10 +375,13 @@ class FilesApi(object):
         Delete multiple files by ID list
         This method makes a synchronous HTTP request by default.
 
-        :param list[str] body: List of IDs to delete (required)
-        :param ContainerDeleteReason delete_reason:
-        :param bool async_: Perform the request asynchronously
-        :return: DeletedResult
+        :param body: List of IDs to delete
+        :type body: list[str]
+        :param delete_reason:
+        :type delete_reason: ContainerDeleteReason, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: DeletedResult
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -387,10 +405,13 @@ class FilesApi(object):
         Delete multiple files by ID list
         This method makes a synchronous HTTP request by default.
 
-        :param list[str] body: List of IDs to delete (required)
-        :param ContainerDeleteReason delete_reason:
-        :param bool async_: Perform the request asynchronously
-        :return: DeletedResult
+        :param body: List of IDs to delete
+        :type body: list[str]
+        :param delete_reason:
+        :type delete_reason: ContainerDeleteReason, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: DeletedResult
         """
 
         all_params = ['body','delete_reason',]  # noqa: E501
@@ -465,14 +486,21 @@ class FilesApi(object):
         Get metadata of all current user files
         This method makes a synchronous HTTP request by default.
 
-        :param str filter: Comma separated filters to apply. Commas not used as separators must be escaped with backslash '\\'. (e.g. label=my-label,created>2018-09-22)
-        :param str sort: The sort fields and order. (e.g. label:asc,created:desc)
-        :param int limit: The maximum number of entries to return.
-        :param int skip: The number of entries to skip.
-        :param int page: The page number (i.e. skip limit*page entries)
-        :param str after_id: Paginate after the given id. (Cannot be used with sort, page or skip)
-        :param bool async_: Perform the request asynchronously
-        :return: PageGenericFileOutput
+        :param filter: Comma separated filters to apply. Commas not used as separators must be escaped with backslash '\\'. (e.g. label=my-label,created>2018-09-22)
+        :type filter: str, optional
+        :param sort: The sort fields and order. (e.g. label:asc,created:desc)
+        :type sort: str, optional
+        :param limit: The maximum number of entries to return.
+        :type limit: int, optional
+        :param skip: The number of entries to skip., defaults to 0
+        :type skip: int, optional
+        :param page: The page number (i.e. skip limit*page entries)
+        :type page: int, optional
+        :param after_id: Paginate after the given id. (Cannot be used with sort, page or skip)
+        :type after_id: str, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: PageGenericFileOutput
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -496,14 +524,21 @@ class FilesApi(object):
         Get metadata of all current user files
         This method makes a synchronous HTTP request by default.
 
-        :param str filter: Comma separated filters to apply. Commas not used as separators must be escaped with backslash '\\'. (e.g. label=my-label,created>2018-09-22)
-        :param str sort: The sort fields and order. (e.g. label:asc,created:desc)
-        :param int limit: The maximum number of entries to return.
-        :param int skip: The number of entries to skip.
-        :param int page: The page number (i.e. skip limit*page entries)
-        :param str after_id: Paginate after the given id. (Cannot be used with sort, page or skip)
-        :param bool async_: Perform the request asynchronously
-        :return: PageGenericFileOutput
+        :param filter: Comma separated filters to apply. Commas not used as separators must be escaped with backslash '\\'. (e.g. label=my-label,created>2018-09-22)
+        :type filter: str, optional
+        :param sort: The sort fields and order. (e.g. label:asc,created:desc)
+        :type sort: str, optional
+        :param limit: The maximum number of entries to return.
+        :type limit: int, optional
+        :param skip: The number of entries to skip., defaults to 0
+        :type skip: int, optional
+        :param page: The page number (i.e. skip limit*page entries)
+        :type page: int, optional
+        :param after_id: Paginate after the given id. (Cannot be used with sort, page or skip)
+        :type after_id: str, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: PageGenericFileOutput
         """
 
         all_params = ['filter','sort','limit','skip','page','after_id',]  # noqa: E501
@@ -578,10 +613,13 @@ class FilesApi(object):
         Get file details
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version:
-        :param bool async_: Perform the request asynchronously
-        :return: FileOutput
+        :param file_id:
+        :type file_id: str
+        :param version:, defaults to 0
+        :type version: int, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: FileOutput
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -605,10 +643,13 @@ class FilesApi(object):
         Get file details
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version:
-        :param bool async_: Perform the request asynchronously
-        :return: FileOutput
+        :param file_id:
+        :type file_id: str
+        :param version:, defaults to 0
+        :type version: int, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: FileOutput
         """
 
         all_params = ['file_id','version',]  # noqa: E501
@@ -679,10 +720,13 @@ class FilesApi(object):
         Get info dict for any file version. Returns:     dict of key/value pairs
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version:
-        :param bool async_: Perform the request asynchronously
-        :return: object
+        :param file_id:
+        :type file_id: str
+        :param version:, defaults to 0
+        :type version: int, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: object
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -706,10 +750,13 @@ class FilesApi(object):
         Get info dict for any file version. Returns:     dict of key/value pairs
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version:
-        :param bool async_: Perform the request asynchronously
-        :return: object
+        :param file_id:
+        :type file_id: str
+        :param version:, defaults to 0
+        :type version: int, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: object
         """
 
         all_params = ['file_id','version',]  # noqa: E501
@@ -780,10 +827,13 @@ class FilesApi(object):
         Return a file tags, from any version
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version:
-        :param bool async_: Perform the request asynchronously
-        :return: list[str]
+        :param file_id:
+        :type file_id: str
+        :param version:, defaults to 0
+        :type version: int, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: list[str]
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -807,10 +857,13 @@ class FilesApi(object):
         Return a file tags, from any version
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version:
-        :param bool async_: Perform the request asynchronously
-        :return: list[str]
+        :param file_id:
+        :type file_id: str
+        :param version:, defaults to 0
+        :type version: int, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: list[str]
         """
 
         all_params = ['file_id','version',]  # noqa: E501
@@ -881,9 +934,11 @@ class FilesApi(object):
         Get file version details
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param bool async_: Perform the request asynchronously
-        :return: list[FileVersionOutput]
+        :param file_id:
+        :type file_id: str
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: list[FileVersionOutput]
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -907,9 +962,11 @@ class FilesApi(object):
         Get file version details
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param bool async_: Perform the request asynchronously
-        :return: list[FileVersionOutput]
+        :param file_id:
+        :type file_id: str
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: list[FileVersionOutput]
         """
 
         all_params = ['file_id',]  # noqa: E501
@@ -978,11 +1035,15 @@ class FilesApi(object):
         Get info on zipfile
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version:
-        :param str ticket:
-        :param bool async_: Perform the request asynchronously
-        :return: ZipfileInfo
+        :param file_id:
+        :type file_id: str
+        :param version:, defaults to 0
+        :type version: int, optional
+        :param ticket:
+        :type ticket: str, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: ZipfileInfo
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -1006,11 +1067,15 @@ class FilesApi(object):
         Get info on zipfile
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version:
-        :param str ticket:
-        :param bool async_: Perform the request asynchronously
-        :return: ZipfileInfo
+        :param file_id:
+        :type file_id: str
+        :param version:, defaults to 0
+        :type version: int, optional
+        :param ticket:
+        :type ticket: str, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: ZipfileInfo
         """
 
         all_params = ['file_id','version','ticket',]  # noqa: E501
@@ -1083,10 +1148,13 @@ class FilesApi(object):
         Modify classification of most recent file version
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param FileClassificationDelta body: (required)
-        :param bool async_: Perform the request asynchronously
-        :return: ModifiedResult
+        :param file_id:
+        :type file_id: str
+        :param body:
+        :type body: FileClassificationDelta
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: ModifiedResult
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -1110,10 +1178,13 @@ class FilesApi(object):
         Modify classification of most recent file version
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param FileClassificationDelta body: (required)
-        :param bool async_: Perform the request asynchronously
-        :return: ModifiedResult
+        :param file_id:
+        :type file_id: str
+        :param body:
+        :type body: FileClassificationDelta
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: ModifiedResult
         """
 
         all_params = ['file_id','body',]  # noqa: E501
@@ -1199,10 +1270,13 @@ class FilesApi(object):
         Add info to most recent file version, adding items or replacing some existing ones. Parameters:     info (dict) -- key/value pairs to add Returns:     dict added
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param object body:
-        :param bool async_: Perform the request asynchronously
-        :return: ModifiedResult
+        :param file_id:
+        :type file_id: str
+        :param body:
+        :type body: object, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: ModifiedResult
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -1226,10 +1300,13 @@ class FilesApi(object):
         Add info to most recent file version, adding items or replacing some existing ones. Parameters:     info (dict) -- key/value pairs to add Returns:     dict added
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param object body:
-        :param bool async_: Perform the request asynchronously
-        :return: ModifiedResult
+        :param file_id:
+        :type file_id: str
+        :param body:
+        :type body: object, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: ModifiedResult
         """
 
         all_params = ['file_id','body',]  # noqa: E501
@@ -1311,10 +1388,13 @@ class FilesApi(object):
         Move a file to a new container and/or give it a new name
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param FileMoveInput body: (required)
-        :param bool async_: Perform the request asynchronously
-        :return: ModifiedResult
+        :param file_id:
+        :type file_id: str
+        :param body:
+        :type body: FileMoveInput
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: ModifiedResult
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -1338,10 +1418,13 @@ class FilesApi(object):
         Move a file to a new container and/or give it a new name
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param FileMoveInput body: (required)
-        :param bool async_: Perform the request asynchronously
-        :return: ModifiedResult
+        :param file_id:
+        :type file_id: str
+        :param body:
+        :type body: FileMoveInput
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: ModifiedResult
         """
 
         all_params = ['file_id','body',]  # noqa: E501
@@ -1427,10 +1510,13 @@ class FilesApi(object):
         Add info to most recent file version, replacing all existing values. Parameters:     info (dict) -- all key/value pairs to populate info Returns:     dict added
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param object body:
-        :param bool async_: Perform the request asynchronously
-        :return: object
+        :param file_id:
+        :type file_id: str
+        :param body:
+        :type body: object, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: object
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -1454,10 +1540,13 @@ class FilesApi(object):
         Add info to most recent file version, replacing all existing values. Parameters:     info (dict) -- all key/value pairs to populate info Returns:     dict added
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param object body:
-        :param bool async_: Perform the request asynchronously
-        :return: object
+        :param file_id:
+        :type file_id: str
+        :param body:
+        :type body: object, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: object
         """
 
         all_params = ['file_id','body',]  # noqa: E501
@@ -1539,11 +1628,15 @@ class FilesApi(object):
         Restore a specific version of a file as the active version. This will create a new version which will be identical to the restored version.
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version: (required)
-        :param bool evaluate_gear_rules: Specify if gear rules should be reevaluated on the newly created file version (required)
-        :param bool async_: Perform the request asynchronously
-        :return: FileOutput
+        :param file_id:
+        :type file_id: str
+        :param version:
+        :type version: int
+        :param evaluate_gear_rules: Specify if gear rules should be reevaluated on the newly created file version
+        :type evaluate_gear_rules: bool
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: FileOutput
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -1567,11 +1660,15 @@ class FilesApi(object):
         Restore a specific version of a file as the active version. This will create a new version which will be identical to the restored version.
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param int version: (required)
-        :param bool evaluate_gear_rules: Specify if gear rules should be reevaluated on the newly created file version (required)
-        :param bool async_: Perform the request asynchronously
-        :return: FileOutput
+        :param file_id:
+        :type file_id: str
+        :param version:
+        :type version: int
+        :param evaluate_gear_rules: Specify if gear rules should be reevaluated on the newly created file version
+        :type evaluate_gear_rules: bool
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: FileOutput
         """
 
         all_params = ['file_id','version','evaluate_gear_rules',]  # noqa: E501
@@ -1652,10 +1749,13 @@ class FilesApi(object):
         Set the tags on a file to the list of tags provided
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param list[str] body: List of application-specific tags (required)
-        :param bool async_: Perform the request asynchronously
-        :return: ModifiedResult
+        :param file_id:
+        :type file_id: str
+        :param body: List of application-specific tags
+        :type body: list[str]
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: ModifiedResult
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -1679,10 +1779,13 @@ class FilesApi(object):
         Set the tags on a file to the list of tags provided
         This method makes a synchronous HTTP request by default.
 
-        :param str file_id: (required)
-        :param list[str] body: List of application-specific tags (required)
-        :param bool async_: Perform the request asynchronously
-        :return: ModifiedResult
+        :param file_id:
+        :type file_id: str
+        :param body: List of application-specific tags
+        :type body: list[str]
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: ModifiedResult
         """
 
         all_params = ['file_id','body',]  # noqa: E501
@@ -1761,10 +1864,13 @@ class FilesApi(object):
         Create or update a file
         This method makes a synchronous HTTP request by default.
 
-        :param FileUpsertInput body: (required)
-        :param bool force_update:
-        :param bool async_: Perform the request asynchronously
-        :return: FileUpsertOutput
+        :param body:
+        :type body: FileUpsertInput
+        :param force_update:, defaults to false
+        :type force_update: bool, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: FileUpsertOutput
         """
         ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
         kwargs['_return_http_data_only'] = True
@@ -1788,10 +1894,13 @@ class FilesApi(object):
         Create or update a file
         This method makes a synchronous HTTP request by default.
 
-        :param FileUpsertInput body: (required)
-        :param bool force_update:
-        :param bool async_: Perform the request asynchronously
-        :return: FileUpsertOutput
+        :param body:
+        :type body: FileUpsertInput
+        :param force_update:, defaults to false
+        :type force_update: bool, optional
+        :param async_: Perform the request asynchronously
+        :type async_: bool, optional
+        :rtype: FileUpsertOutput
         """
 
         all_params = ['body','force_update',]  # noqa: E501