update public api

Author: iLLiCiTiT

ayon_api/__init__.py

@@ -214,6 +214,7 @@
     get_thumbnail_by_id,
     get_thumbnail,
     get_folder_thumbnail,
+    get_task_thumbnail,
     get_version_thumbnail,
     get_workfile_thumbnail,
     create_thumbnail,
@@ -459,6 +460,7 @@
     "get_thumbnail_by_id",
     "get_thumbnail",
     "get_folder_thumbnail",
+    "get_task_thumbnail",
     "get_version_thumbnail",
     "get_workfile_thumbnail",
     "create_thumbnail",

ayon_api/_api.py

@@ -5698,9 +5698,10 @@ def get_thumbnail_by_id(
 ) -> ThumbnailContent:
     """Get thumbnail from server by id.
 
-    Permissions of thumbnails are related to entities so thumbnails must
-    be queried per entity. So an entity type and entity type is required
-    to be passed.
+    Warnings:
+        Please keep in mind that used endpoint is allowed only for admins
+            and managers. Use 'get_thumbnail' with entity type and id
+            to allow access for artists.
 
     Notes:
         It is recommended to use one of prepared entity type specific
@@ -5736,7 +5737,7 @@ def get_thumbnail(
     """Get thumbnail from server.
 
     Permissions of thumbnails are related to entities so thumbnails must
-    be queried per entity. So an entity type and entity type is required
+    be queried per entity. So an entity type and entity id is required
     to be passed.
 
     Notes:
@@ -5794,6 +5795,28 @@ def get_folder_thumbnail(
     )
 
 
+def get_task_thumbnail(
+    project_name: str,
+    task_id: str,
+) -> ThumbnailContent:
+    """Prepared method to receive thumbnail for task entity.
+
+    Args:
+        project_name (str): Project under which the entity is located.
+        task_id (str): Folder id for which thumbnail should be returned.
+
+    Returns:
+        ThumbnailContent: Thumbnail content wrapper. Does not have to be
+            valid.
+
+    """
+    con = get_server_api_connection()
+    return con.get_task_thumbnail(
+        project_name=project_name,
+        task_id=task_id,
+    )
+
+
 def get_version_thumbnail(
     project_name: str,
     version_id: str,