appwrite 22.1.0__tar.gz → 22.2.0__tar.gz

{appwrite-22.1.0 → appwrite-22.2.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: appwrite
-Version: 22.1.0
+Version: 22.2.0
 Summary: Appwrite is an open-source self-hosted backend server that abstracts and simplifies complex and repetitive development tasks behind a very simple REST API
 Home-page: https://appwrite.io/support
-Download-URL: https://github.com/appwrite/sdk-for-python/archive/22.1.0.tar.gz
+Download-URL: https://github.com/appwrite/sdk-for-python/archive/22.2.0.tar.gz
 Author: Appwrite Team
 Author-email: Appwrite Team <team@appwrite.io>
 Maintainer: Appwrite Team

{appwrite-22.1.0 → appwrite-22.2.0}/appwrite/client.py

@@ -17,11 +17,11 @@ class Client:
         self._endpoint = 'https://cloud.appwrite.io/v1'
         self._global_headers = {
             'content-type': '',
-            'user-agent' : f'AppwritePythonSDK/22.1.0 ({platform.uname().system}; {platform.uname().version}; {platform.uname().machine})',
+            'user-agent' : f'AppwritePythonSDK/22.2.0 ({platform.uname().system}; {platform.uname().version}; {platform.uname().machine})',
             'x-sdk-name': 'Python',
             'x-sdk-platform': 'server',
             'x-sdk-language': 'python',
-            'x-sdk-version': '22.1.0',
+            'x-sdk-version': '22.2.0',
             'X-Appwrite-Response-Format' : '1.9.5',
         }
         self._config = {}

{appwrite-22.1.0 → appwrite-22.2.0}/appwrite/enums/organization_key_scopes.py

@@ -7,6 +7,8 @@ class OrganizationKeyScopes(Enum):
     DEVKEYS_WRITE = "devKeys.write"
     ORGANIZATION_KEYS_READ = "organization.keys.read"
     ORGANIZATION_KEYS_WRITE = "organization.keys.write"
+    ORGANIZATION_INSTALLATIONS_READ = "organization.installations.read"
+    ORGANIZATION_INSTALLATIONS_WRITE = "organization.installations.write"
     ORGANIZATION_MEMBERSHIPS_READ = "organization.memberships.read"
     ORGANIZATION_MEMBERSHIPS_WRITE = "organization.memberships.write"
     ORGANIZATION_READ = "organization.read"

{appwrite-22.1.0 → appwrite-22.2.0}/appwrite/models/__init__.py

@@ -243,6 +243,8 @@ from .app import App
 from .app_secret import AppSecret
 from .app_secret_plaintext import AppSecretPlaintext
 from .app_scope import AppScope
+from .app_installation import AppInstallation
+from .app_key import AppKey
 from .oauth2_authorize import Oauth2Authorize
 from .oauth2_approve import Oauth2Approve
 from .oauth2_reject import Oauth2Reject
@@ -265,6 +267,8 @@ from .backup_restoration_list import BackupRestorationList
 from .apps_list import AppsList
 from .app_secret_list import AppSecretList
 from .app_scope_list import AppScopeList
+from .app_installation_list import AppInstallationList
+from .app_key_list import AppKeyList
 
 __all__ = [
     'AppwriteModel',
@@ -512,6 +516,8 @@ __all__ = [
     'AppSecret',
     'AppSecretPlaintext',
     'AppScope',
+    'AppInstallation',
+    'AppKey',
     'Oauth2Authorize',
     'Oauth2Approve',
     'Oauth2Reject',
@@ -534,4 +540,6 @@ __all__ = [
     'AppsList',
     'AppSecretList',
     'AppScopeList',
+    'AppInstallationList',
+    'AppKeyList',
 ]

{appwrite-22.1.0 → appwrite-22.2.0}/appwrite/models/app.py

@@ -56,6 +56,10 @@ class App(AppwriteModel):
         ID of team that owns the application, if owned by team. Otherwise, user ID will be used.
     userid : str
         ID of user who owns the application, if owned by user. Otherwise, team ID will be used.
+    installationscopes : List[Any]
+        Scopes the application requests when installed on a team. Organization-level and project-level scopes only.
+    installationredirecturl : str
+        URL users are redirected to after creating or updating an installation of this application. Empty for no redirect.
     secrets : List[AppSecret]
         List of application secrets.
     """
@@ -82,4 +86,6 @@ class App(AppwriteModel):
     deviceflow: bool = Field(..., alias='deviceFlow')
     teamid: str = Field(..., alias='teamId')
     userid: str = Field(..., alias='userId')
+    installationscopes: List[Any] = Field(..., alias='installationScopes')
+    installationredirecturl: str = Field(..., alias='installationRedirectUrl')
     secrets: List[AppSecret] = Field(..., alias='secrets')

appwrite-22.2.0/appwrite/models/app_installation.py

@@ -0,0 +1,42 @@
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
+
+from .base_model import AppwriteModel
+
+class AppInstallation(AppwriteModel):
+    """
+    AppInstallation
+
+    Attributes
+    ----------
+    id : str
+        Installation ID.
+    createdat : str
+        Installation creation time in ISO 8601 format.
+    updatedat : str
+        Installation update time in ISO 8601 format.
+    appid : str
+        ID of the installed application.
+    teamid : str
+        ID of the team the application is installed on.
+    scopes : List[Any]
+        Scopes granted to the application. Snapshot of the application's installation scopes taken when the installation was created or last updated.
+    authorizationdetails : Dict[str, Any]
+        Authorization details granted to the application. Rich authorization request (RFC 9396) style entries; the Appwrite Console stores authorized project IDs here.
+    createdbyid : str
+        ID of the user who created the installation.
+    createdbyname : str
+        Name of the user who created the installation.
+    lastaccessedat : Optional[str]
+        Time an access token was last issued for the installation in ISO 8601 format. Null if never used.
+    """
+    id: str = Field(..., alias='$id')
+    createdat: str = Field(..., alias='$createdAt')
+    updatedat: str = Field(..., alias='$updatedAt')
+    appid: str = Field(..., alias='appId')
+    teamid: str = Field(..., alias='teamId')
+    scopes: List[Any] = Field(..., alias='scopes')
+    authorizationdetails: Dict[str, Any] = Field(..., alias='authorizationDetails')
+    createdbyid: str = Field(..., alias='createdById')
+    createdbyname: str = Field(..., alias='createdByName')
+    lastaccessedat: Optional[str] = Field(default=None, alias='lastAccessedAt')

appwrite-22.2.0/appwrite/models/app_installation_list.py

@@ -0,0 +1,19 @@
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
+
+from .base_model import AppwriteModel
+from .app_installation import AppInstallation
+
+class AppInstallationList(AppwriteModel):
+    """
+    App installations list
+
+    Attributes
+    ----------
+    total : float
+        Total number of installations that matched your query.
+    installations : List[AppInstallation]
+        List of installations.
+    """
+    total: float = Field(..., alias='total')
+    installations: List[AppInstallation] = Field(..., alias='installations')

appwrite-22.2.0/appwrite/models/app_key.py

@@ -0,0 +1,39 @@
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
+
+from .base_model import AppwriteModel
+
+class AppKey(AppwriteModel):
+    """
+    AppKey
+
+    Attributes
+    ----------
+    id : str
+        App key ID.
+    createdat : str
+        App key creation time in ISO 8601 format.
+    updatedat : str
+        App key update time in ISO 8601 format.
+    appid : str
+        Application ID this app key belongs to.
+    secret : str
+        App key secret.
+    hint : str
+        Last few characters of the app key secret, used to help identify it.
+    createdbyid : str
+        ID of the user who created the app key.
+    createdbyname : str
+        Name of the user who created the app key.
+    lastaccessedat : Optional[str]
+        Time the app key was last used for authentication in ISO 8601 format. Null if never used.
+    """
+    id: str = Field(..., alias='$id')
+    createdat: str = Field(..., alias='$createdAt')
+    updatedat: str = Field(..., alias='$updatedAt')
+    appid: str = Field(..., alias='appId')
+    secret: str = Field(..., alias='secret')
+    hint: str = Field(..., alias='hint')
+    createdbyid: str = Field(..., alias='createdById')
+    createdbyname: str = Field(..., alias='createdByName')
+    lastaccessedat: Optional[str] = Field(default=None, alias='lastAccessedAt')

appwrite-22.2.0/appwrite/models/app_key_list.py

@@ -0,0 +1,19 @@
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
+
+from .base_model import AppwriteModel
+from .app_key import AppKey
+
+class AppKeyList(AppwriteModel):
+    """
+    App keys list
+
+    Attributes
+    ----------
+    total : float
+        Total number of keys that matched your query.
+    keys : List[AppKey]
+        List of keys.
+    """
+    total: float = Field(..., alias='total')
+    keys: List[AppKey] = Field(..., alias='keys')

{appwrite-22.1.0 → appwrite-22.2.0}/appwrite/models/database.py

@@ -27,6 +27,10 @@ class Database(AppwriteModel):
         Database type.
     status : Optional[DatabaseStatus]
         Dedicated database lifecycle status. Null when the database has no valid dedicated backing.
+    engine : Optional[str]
+        Underlying engine of the dedicated backing: postgresql, mysql, mariadb, or mongodb. A managed product (tablesdb, documentsdb, vectorsdb) reports the engine it runs on, so its type and engine can differ. Null when the database has no dedicated backing.
+    specification : Optional[str]
+        Compute specification identifier of the dedicated backing, e.g. s-2vcpu-2gb. Null when the database has no dedicated backing.
     replicas : Optional[float]
         Number of secondary high availability replicas, excluding the primary. Null when backing configuration is unavailable.
     policies : Optional[List[BackupPolicy]]
@@ -41,6 +45,8 @@ class Database(AppwriteModel):
     enabled: bool = Field(..., alias='enabled')
     type: DatabaseType = Field(..., alias='type')
     status: Optional[DatabaseStatus] = Field(default=None, alias='status')
+    engine: Optional[str] = Field(default=None, alias='engine')
+    specification: Optional[str] = Field(default=None, alias='specification')
     replicas: Optional[float] = Field(default=None, alias='replicas')
     policies: Optional[List[BackupPolicy]] = Field(default=None, alias='policies')
     archives: Optional[List[BackupArchive]] = Field(default=None, alias='archives')

{appwrite-22.1.0 → appwrite-22.2.0}/appwrite/models/project.py

@@ -91,6 +91,8 @@ class Project(AppwriteModel):
         OAuth2 server access token duration in seconds for public clients (SPAs, mobile, native)
     oauth2serverpublicrefreshtokenduration : Optional[float]
         OAuth2 server refresh token duration in seconds for public clients (SPAs, mobile, native)
+    oauth2serverinstallationaccesstokenduration : Optional[float]
+        OAuth2 server access token duration in seconds for app installation access tokens
     oauth2serverconfidentialpkce : Optional[bool]
         When enabled, PKCE is required for confidential clients (server-side flows using client_secret). PKCE is always required for public clients regardless of this setting.
     oauth2serververificationurl : Optional[str]
@@ -142,6 +144,7 @@ class Project(AppwriteModel):
     oauth2serverrefreshtokenduration: Optional[float] = Field(default=None, alias='oAuth2ServerRefreshTokenDuration')
     oauth2serverpublicaccesstokenduration: Optional[float] = Field(default=None, alias='oAuth2ServerPublicAccessTokenDuration')
     oauth2serverpublicrefreshtokenduration: Optional[float] = Field(default=None, alias='oAuth2ServerPublicRefreshTokenDuration')
+    oauth2serverinstallationaccesstokenduration: Optional[float] = Field(default=None, alias='oAuth2ServerInstallationAccessTokenDuration')
     oauth2serverconfidentialpkce: Optional[bool] = Field(default=None, alias='oAuth2ServerConfidentialPkce')
     oauth2serververificationurl: Optional[str] = Field(default=None, alias='oAuth2ServerVerificationUrl')
     oauth2serverusercodelength: Optional[float] = Field(default=None, alias='oAuth2ServerUserCodeLength')

{appwrite-22.1.0 → appwrite-22.2.0}/appwrite/services/apps.py

@@ -6,6 +6,11 @@ from appwrite.utils.deprecated import deprecated
 from ..models.apps_list import AppsList
 from ..models.app import App
 from ..models.app_scope_list import AppScopeList
+from ..models.app_installation_list import AppInstallationList
+from ..models.app_installation import AppInstallation
+from ..models.oauth2_token import Oauth2Token
+from ..models.app_key_list import AppKeyList
+from ..models.app_key import AppKey
 from ..models.app_secret_list import AppSecretList
 from ..models.app_secret_plaintext import AppSecretPlaintext
 from ..models.app_secret import AppSecret
@@ -191,6 +196,34 @@ class Apps(Service):
         return self._parse_response(response, model=App)
 
 
+    def list_installation_scopes(
+        self
+    ) -> AppScopeList:
+        """
+        List scopes an application can request when installed on a team.
+
+        Returns
+        -------
+        AppScopeList
+            API response as a typed Pydantic model
+        
+        Raises
+        ------
+        AppwriteException
+            If API request fails
+        """
+
+        api_path = '/apps/scopes/installations'
+        api_params = {}
+
+        response = self.client.call('get', api_path, {
+            'X-Appwrite-Project': self.client.get_config('project'),
+            'accept': 'application/json',
+        }, api_params)
+
+        return self._parse_response(response, model=AppScopeList)
+
+
     def list_o_auth2_scopes(
         self
     ) -> AppScopeList:
@@ -277,7 +310,9 @@ class Apps(Service):
         redirect_uris: Optional[List[str]] = None,
         post_logout_redirect_uris: Optional[List[str]] = None,
         type: Optional[str] = None,
-        device_flow: Optional[bool] = None
+        device_flow: Optional[bool] = None,
+        installation_scopes: Optional[List[str]] = None,
+        installation_redirect_url: Optional[str] = None
     ) -> App:
         """
         Update an application by its unique ID.
@@ -320,6 +355,10 @@ class Apps(Service):
             OAuth2 client type. Use `public` for SPAs, mobile, and native apps that cannot keep a `client_secret` — PKCE is then required at the token endpoint. Use `confidential` for server-side clients that present a `client_secret`. Defaults to `confidential`.
         device_flow : Optional[bool]
             Allow this client to use the OAuth2 Device Authorization Grant (RFC 8628) for input-constrained devices such as TVs and CLIs. Defaults to false.
+        installation_scopes : Optional[List[str]]
+            Scopes the application requests when installed on a team. Organization-level and project-level scopes only; use the list scopes endpoint with `type=installation` to discover available values. Maximum of 100 scopes are allowed.
+        installation_redirect_url : Optional[str]
+            URL users are redirected to after creating or updating an installation of this application. Must be an https URL, an http loopback URL (localhost, 127.0.0.1, [::1]), or a private-use scheme URI, and must not contain a fragment. Leave empty for no redirect.
         
         Returns
         -------
@@ -375,6 +414,10 @@ class Apps(Service):
             api_params['type'] = self._normalize_value(type)
         if device_flow is not None:
             api_params['deviceFlow'] = self._normalize_value(device_flow)
+        if installation_scopes is not None:
+            api_params['installationScopes'] = self._normalize_value(installation_scopes)
+        if installation_redirect_url is not None:
+            api_params['installationRedirectUrl'] = self._normalize_value(installation_redirect_url)
 
         response = self.client.call('put', api_path, {
             'X-Appwrite-Project': self.client.get_config('project'),
@@ -425,6 +468,330 @@ class Apps(Service):
         return response
 
 
+    def list_installations(
+        self,
+        app_id: str,
+        queries: Optional[List[str]] = None,
+        total: Optional[bool] = None
+    ) -> AppInstallationList:
+        """
+        List installations of an application. Requires an app key sent in the `X-Appwrite-Key` header alongside the `X-Appwrite-App` header.
+
+        Parameters
+        ----------
+        app_id : str
+            Application unique ID.
+        queries : Optional[List[str]]
+            Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long.
+        total : Optional[bool]
+            When set to false, the total count returned will be 0 and will not be calculated.
+        
+        Returns
+        -------
+        AppInstallationList
+            API response as a typed Pydantic model
+        
+        Raises
+        ------
+        AppwriteException
+            If API request fails
+        """
+
+        api_path = '/apps/{appId}/installations'
+        api_params = {}
+        if app_id is None:
+            raise AppwriteException('Missing required parameter: "app_id"')
+
+        api_path = api_path.replace('{appId}', str(self._normalize_value(app_id)))
+
+        if queries is not None:
+            api_params['queries'] = self._normalize_value(queries)
+        if total is not None:
+            api_params['total'] = self._normalize_value(total)
+
+        response = self.client.call('get', api_path, {
+            'X-Appwrite-Project': self.client.get_config('project'),
+            'accept': 'application/json',
+        }, api_params)
+
+        return self._parse_response(response, model=AppInstallationList)
+
+
+    def get_installation(
+        self,
+        app_id: str,
+        installation_id: str
+    ) -> AppInstallation:
+        """
+        Get an installation of an application by its unique ID. Requires an app key sent in the `X-Appwrite-Key` header alongside the `X-Appwrite-App` header.
+
+        Parameters
+        ----------
+        app_id : str
+            Application unique ID.
+        installation_id : str
+            Installation unique ID.
+        
+        Returns
+        -------
+        AppInstallation
+            API response as a typed Pydantic model
+        
+        Raises
+        ------
+        AppwriteException
+            If API request fails
+        """
+
+        api_path = '/apps/{appId}/installations/{installationId}'
+        api_params = {}
+        if app_id is None:
+            raise AppwriteException('Missing required parameter: "app_id"')
+
+        if installation_id is None:
+            raise AppwriteException('Missing required parameter: "installation_id"')
+
+        api_path = api_path.replace('{appId}', str(self._normalize_value(app_id)))
+        api_path = api_path.replace('{installationId}', str(self._normalize_value(installation_id)))
+
+
+        response = self.client.call('get', api_path, {
+            'X-Appwrite-Project': self.client.get_config('project'),
+            'accept': 'application/json',
+        }, api_params)
+
+        return self._parse_response(response, model=AppInstallation)
+
+
+    def create_installation_token(
+        self,
+        app_id: str,
+        installation_id: str
+    ) -> Oauth2Token:
+        """
+        Create a token for an installation of an application. Requires an app key sent in the `X-Appwrite-Key` header alongside the `X-Appwrite-App` header. The returned token carries the scopes and authorization details granted to the installation, and can be used as an `Authorization: Bearer` header everywhere OAuth2 access tokens are accepted. Multiple tokens can be active for the same installation at once; each token stays valid until it expires or the installation is updated or deleted.
+
+        Parameters
+        ----------
+        app_id : str
+            Application unique ID.
+        installation_id : str
+            Installation unique ID.
+        
+        Returns
+        -------
+        Oauth2Token
+            API response as a typed Pydantic model
+        
+        Raises
+        ------
+        AppwriteException
+            If API request fails
+        """
+
+        api_path = '/apps/{appId}/installations/{installationId}/tokens'
+        api_params = {}
+        if app_id is None:
+            raise AppwriteException('Missing required parameter: "app_id"')
+
+        if installation_id is None:
+            raise AppwriteException('Missing required parameter: "installation_id"')
+
+        api_path = api_path.replace('{appId}', str(self._normalize_value(app_id)))
+        api_path = api_path.replace('{installationId}', str(self._normalize_value(installation_id)))
+
+
+        response = self.client.call('post', api_path, {
+            'X-Appwrite-Project': self.client.get_config('project'),
+            'content-type': 'application/json',
+            'accept': 'application/json',
+        }, api_params)
+
+        return self._parse_response(response, model=Oauth2Token)
+
+
+    def list_keys(
+        self,
+        app_id: str,
+        queries: Optional[List[str]] = None,
+        total: Optional[bool] = None
+    ) -> AppKeyList:
+        """
+        List app keys for an application.
+
+        Parameters
+        ----------
+        app_id : str
+            Application unique ID.
+        queries : Optional[List[str]]
+            Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long.
+        total : Optional[bool]
+            When set to false, the total count returned will be 0 and will not be calculated.
+        
+        Returns
+        -------
+        AppKeyList
+            API response as a typed Pydantic model
+        
+        Raises
+        ------
+        AppwriteException
+            If API request fails
+        """
+
+        api_path = '/apps/{appId}/keys'
+        api_params = {}
+        if app_id is None:
+            raise AppwriteException('Missing required parameter: "app_id"')
+
+        api_path = api_path.replace('{appId}', str(self._normalize_value(app_id)))
+
+        if queries is not None:
+            api_params['queries'] = self._normalize_value(queries)
+        if total is not None:
+            api_params['total'] = self._normalize_value(total)
+
+        response = self.client.call('get', api_path, {
+            'X-Appwrite-Project': self.client.get_config('project'),
+            'accept': 'application/json',
+        }, api_params)
+
+        return self._parse_response(response, model=AppKeyList)
+
+
+    def create_key(
+        self,
+        app_id: str
+    ) -> AppKey:
+        """
+        Create a new app key for an application. App keys carry no scopes; send one in the `X-Appwrite-Key` header alongside the `X-Appwrite-App` header to list the application's installations and create installation access tokens.
+
+        Parameters
+        ----------
+        app_id : str
+            Application unique ID.
+        
+        Returns
+        -------
+        AppKey
+            API response as a typed Pydantic model
+        
+        Raises
+        ------
+        AppwriteException
+            If API request fails
+        """
+
+        api_path = '/apps/{appId}/keys'
+        api_params = {}
+        if app_id is None:
+            raise AppwriteException('Missing required parameter: "app_id"')
+
+        api_path = api_path.replace('{appId}', str(self._normalize_value(app_id)))
+
+
+        response = self.client.call('post', api_path, {
+            'X-Appwrite-Project': self.client.get_config('project'),
+            'content-type': 'application/json',
+            'accept': 'application/json',
+        }, api_params)
+
+        return self._parse_response(response, model=AppKey)
+
+
+    def get_key(
+        self,
+        app_id: str,
+        key_id: str
+    ) -> AppKey:
+        """
+        Get an app key by its unique ID.
+
+        Parameters
+        ----------
+        app_id : str
+            Application unique ID.
+        key_id : str
+            App key unique ID.
+        
+        Returns
+        -------
+        AppKey
+            API response as a typed Pydantic model
+        
+        Raises
+        ------
+        AppwriteException
+            If API request fails
+        """
+
+        api_path = '/apps/{appId}/keys/{keyId}'
+        api_params = {}
+        if app_id is None:
+            raise AppwriteException('Missing required parameter: "app_id"')
+
+        if key_id is None:
+            raise AppwriteException('Missing required parameter: "key_id"')
+
+        api_path = api_path.replace('{appId}', str(self._normalize_value(app_id)))
+        api_path = api_path.replace('{keyId}', str(self._normalize_value(key_id)))
+
+
+        response = self.client.call('get', api_path, {
+            'X-Appwrite-Project': self.client.get_config('project'),
+            'accept': 'application/json',
+        }, api_params)
+
+        return self._parse_response(response, model=AppKey)
+
+
+    def delete_key(
+        self,
+        app_id: str,
+        key_id: str
+    ) -> Dict[str, Any]:
+        """
+        Delete an app key by its unique ID.
+
+        Parameters
+        ----------
+        app_id : str
+            Application unique ID.
+        key_id : str
+            App key unique ID.
+        
+        Returns
+        -------
+        Dict[str, Any]
+            API response as a dictionary
+        
+        Raises
+        ------
+        AppwriteException
+            If API request fails
+        """
+
+        api_path = '/apps/{appId}/keys/{keyId}'
+        api_params = {}
+        if app_id is None:
+            raise AppwriteException('Missing required parameter: "app_id"')
+
+        if key_id is None:
+            raise AppwriteException('Missing required parameter: "key_id"')
+
+        api_path = api_path.replace('{appId}', str(self._normalize_value(app_id)))
+        api_path = api_path.replace('{keyId}', str(self._normalize_value(key_id)))
+
+
+        response = self.client.call('delete', api_path, {
+            'X-Appwrite-Project': self.client.get_config('project'),
+            'content-type': 'application/json',
+            'accept': 'application/json',
+        }, api_params)
+
+        return response
+
+
     def update_labels(
         self,
         app_id: str,