semantic-link-labs 0.12.2__tar.gz → 0.12.3__tar.gz

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semantic-link-labs
-Version: 0.12.2
+Version: 0.12.3
 Summary: Semantic Link Labs for Microsoft Fabric
 Author: Microsoft Corporation
 License: MIT License
@@ -26,7 +26,7 @@ Dynamic: license-file
 # Semantic Link Labs
 
 [![PyPI version](https://badge.fury.io/py/semantic-link-labs.svg)](https://badge.fury.io/py/semantic-link-labs)
-[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.2&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.3&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![Downloads](https://static.pepy.tech/badge/semantic-link-labs)](https://pepy.tech/project/semantic-link-labs)
 
@@ -154,6 +154,7 @@ An even better way to ensure the semantic-link-labs library is available in your
 2. Select your newly created environment within the 'Environment' drop down in the navigation bar at the top of the notebook
 
 ## Version History
+* [0.12.3](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.3) (September 17, 2025)
 * [0.12.2](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.2) (September 12, 2025)
 * [0.12.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.1) (September 4, 2025)
 * [0.12.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.0) (September 2, 2025)

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/README.md

@@ -1,7 +1,7 @@
 # Semantic Link Labs
 
 [![PyPI version](https://badge.fury.io/py/semantic-link-labs.svg)](https://badge.fury.io/py/semantic-link-labs)
-[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.2&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.3&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![Downloads](https://static.pepy.tech/badge/semantic-link-labs)](https://pepy.tech/project/semantic-link-labs)
 
@@ -129,6 +129,7 @@ An even better way to ensure the semantic-link-labs library is available in your
 2. Select your newly created environment within the 'Environment' drop down in the navigation bar at the top of the notebook
 
 ## Version History
+* [0.12.3](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.3) (September 17, 2025)
 * [0.12.2](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.2) (September 12, 2025)
 * [0.12.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.1) (September 4, 2025)
 * [0.12.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.0) (September 2, 2025)

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/docs/source/conf.py

@@ -13,7 +13,7 @@ sys.path.insert(0, os.path.abspath('../../src/'))
 project = 'semantic-link-labs'
 copyright = '2024, Microsoft and community'
 author = 'Microsoft and community'
-release = '0.12.2'
+release = '0.12.3'
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/pyproject.toml

@@ -7,7 +7,7 @@ name="semantic-link-labs"
 authors = [
     { name = "Microsoft Corporation" },
 ]
-version="0.12.2"
+version="0.12.3"
 description="Semantic Link Labs for Microsoft Fabric"
 readme="README.md"
 requires-python=">=3.10,<3.12"

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/src/semantic_link_labs.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semantic-link-labs
-Version: 0.12.2
+Version: 0.12.3
 Summary: Semantic Link Labs for Microsoft Fabric
 Author: Microsoft Corporation
 License: MIT License
@@ -26,7 +26,7 @@ Dynamic: license-file
 # Semantic Link Labs
 
 [![PyPI version](https://badge.fury.io/py/semantic-link-labs.svg)](https://badge.fury.io/py/semantic-link-labs)
-[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.2&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.3&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![Downloads](https://static.pepy.tech/badge/semantic-link-labs)](https://pepy.tech/project/semantic-link-labs)
 
@@ -154,6 +154,7 @@ An even better way to ensure the semantic-link-labs library is available in your
 2. Select your newly created environment within the 'Environment' drop down in the navigation bar at the top of the notebook
 
 ## Version History
+* [0.12.3](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.3) (September 17, 2025)
 * [0.12.2](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.2) (September 12, 2025)
 * [0.12.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.1) (September 4, 2025)
 * [0.12.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.0) (September 2, 2025)

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/src/semantic_link_labs.egg-info/SOURCES.txt

@@ -61,6 +61,7 @@ src/sempy_labs/_eventstreams.py
 src/sempy_labs/_external_data_shares.py
 src/sempy_labs/_gateways.py
 src/sempy_labs/_generate_semantic_model.py
+src/sempy_labs/_get_connection_string.py
 src/sempy_labs/_git.py
 src/sempy_labs/_graphQL.py
 src/sempy_labs/_helper_functions.py
@@ -175,6 +176,7 @@ src/sempy_labs/directlake/_warm_cache.py
 src/sempy_labs/dotnet_lib/dotnet.runtime.config.json
 src/sempy_labs/graph/__init__.py
 src/sempy_labs/graph/_groups.py
+src/sempy_labs/graph/_sensitivity_labels.py
 src/sempy_labs/graph/_teams.py
 src/sempy_labs/graph/_users.py
 src/sempy_labs/lakehouse/__init__.py

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/src/sempy_labs/__init__.py

@@ -31,6 +31,8 @@ from ._semantic_models import (
     delete_semantic_model,
     update_semantic_model_refresh_schedule,
     list_semantic_model_datasources,
+    bind_semantic_model_connection,
+    unbind_semantic_model_connection,
 )
 from ._graphQL import (
     list_graphql_apis,
@@ -100,7 +102,6 @@ from ._warehouses import (
     delete_warehouse,
     get_warehouse_columns,
     get_warehouse_tables,
-    get_warehouse_connection_string,
 )
 from ._data_pipelines import (
     list_data_pipelines,
@@ -351,6 +352,9 @@ from ._user_delegation_key import (
 from ._data_access_security import (
     list_data_access_roles,
 )
+from ._get_connection_string import (
+    get_connection_string,
+)
 
 __all__ = [
     "resolve_warehouse_id",
@@ -603,6 +607,8 @@ __all__ = [
     "get_item_definition",
     "get_workspace_network_communication_policy",
     "set_workspace_network_communication_policy",
-    "get_warehouse_connection_string",
+    "get_connection_string",
     "list_data_access_roles",
+    "bind_semantic_model_connection",
+    "unbind_semantic_model_connection",
 ]

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/src/sempy_labs/_a_lib_info.py

@@ -1,2 +1,2 @@
 lib_name = "semanticlinklabs"
-lib_version = "0.12.2"
+lib_version = "0.12.3"

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/src/sempy_labs/_generate_semantic_model.py

@@ -22,7 +22,7 @@ from uuid import UUID
 @log
 def create_blank_semantic_model(
     dataset: str,
-    compatibility_level: int = 1605,
+    compatibility_level: int = 1702,
     workspace: Optional[str | UUID] = None,
     overwrite: bool = True,
 ):
@@ -33,7 +33,7 @@ def create_blank_semantic_model(
     ----------
     dataset : str
         Name of the semantic model.
-    compatibility_level : int, default=1605
+    compatibility_level : int, default=1702
         The compatibility level of the semantic model.
     workspace : str | uuid.UUID, default=None
         The Fabric workspace name or ID.

semantic_link_labs-0.12.3/src/sempy_labs/_get_connection_string.py

@@ -0,0 +1,84 @@
+from sempy_labs._helper_functions import (
+    resolve_item_id,
+    _base_api,
+    resolve_workspace_id,
+)
+from typing import Optional, Literal
+import sempy_labs._icons as icons
+from uuid import UUID
+from sempy._utils._log import log
+
+
+@log
+def get_connection_string(
+    item: str | UUID,
+    type: Literal["Lakehouse", "Warehouse", "SQLEndpoint"],
+    workspace: Optional[str | UUID] = None,
+    guest_tenant_id: Optional[UUID] = None,
+    private_link_type: Optional[str] = None,
+) -> str:
+    """
+    Returns the SQL connection string of the specified item.
+
+    Parameters
+    ----------
+    item : str | uuid.UUID
+        The name or ID of the item (Lakehouse or MirroredDatabase).
+    type : Literal['Lakehouse', 'Warehouse', 'SQLEndpoint']
+        The type of the item. Must be 'Lakehouse' or 'MirroredDatabase'.
+    workspace : str | uuid.UUID, default=None
+        The Fabric workspace name or ID.
+        Defaults to None which resolves to the workspace of the attached lakehouse
+        or if no lakehouse attached, resolves to the workspace of the notebook.
+    guest_tenant_id : uuid.UUID, default=None
+        The guest tenant ID if the end user's tenant is different from the warehouse tenant.
+    private_link_type : str, default=None
+        Indicates the type of private link this connection string uses. Must be either 'Workspace' or 'None' or left as None.
+
+    Returns
+    -------
+    str
+        Returns the SQL connection string of the specified item.
+    """
+    workspace_id = resolve_workspace_id(workspace)
+    item_id = resolve_item_id(item=item, type=type, workspace=workspace)
+
+    type_dict = {
+        "Warehouse": "warehouses",
+        "SQLEndpoint": "sqlEndpoints",
+    }
+    type_for_url = type_dict.get(type)
+
+    if type == "Lakehouse":
+        response = _base_api(
+            f"/v1/workspaces/{workspace_id}/lakehouses/{item_id}", client="fabric_sp"
+        ).json()
+        return (
+            response.get("properties", {})
+            .get("sqlEndpointProperties", {})
+            .get("connectionString", {})
+        )
+    if type in ["SQLEndpoint", "Warehouse"]:
+        url = f"/v1/workspaces/{workspace_id}/{type_for_url}/{item_id}/connectionString"
+    else:
+        raise ValueError(
+            f"{icons.red_dot} The type must be 'Lakehouse', 'Warehouse' or 'SQLEndpoint'."
+        )
+
+    if private_link_type is not None and private_link_type not in ["Workspace", "None"]:
+        raise ValueError(
+            f"{icons.red_dot} private_link_type must be 'Workspace' or 'None' or left as None."
+        )
+
+    if guest_tenant_id or private_link_type:
+        params = []
+        if guest_tenant_id:
+            params.append(f"guestTenantId={guest_tenant_id}")
+        if private_link_type:
+            params.append(f"privateLinkType={private_link_type}")
+        param_str = "?" + "&".join(params)
+        url += param_str
+
+    response = _base_api(request=url, client="fabric_sp")
+
+    return response.json().get("connectionString")

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/src/sempy_labs/_helper_functions.py

@@ -549,6 +549,7 @@ def get_item_definition(
             definition["definition"]["parts"].append(
                 {"path": path, "payload": decoded_payload}
             )
+        return definition
     else:
         return result
 

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/src/sempy_labs/_semantic_models.py

@@ -348,3 +348,121 @@ def list_semantic_model_datasources(
         df = pd.DataFrame(rows, columns=list(columns.keys()))
 
     return df
+
+
+@log
+def bind_semantic_model_connection(
+    dataset: str | UUID,
+    connection_id: UUID,
+    connectivity_type: str,
+    connection_type: str,
+    connection_path: str,
+    workspace: Optional[str | UUID] = None,
+):
+    """
+    Binds a semantic model data source reference to a data connection.
+    This API can also be used to unbind data source references.
+
+    This is a wrapper function for the following API: `Items - Bind Semantic Model Connection <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/bind-semantic-model-connection>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    dataset : str | uuid.UUID
+        Name or ID of the semantic model.
+    connection_id : uuid.UUID
+        The object ID of the connection.
+    connectivity_type : str
+        The connectivity type of the connection. Additional connectivity types may be added over time.
+    connection_type : str
+        The `type <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/bind-semantic-model-connection?tabs=HTTP#connectivitytype>`_ of the connection.
+    connection_path : str
+        The path of the connection.
+    workspace : str | uuid.UUID, default=None
+        The workspace name or ID.
+        Defaults to None which resolves to the workspace of the attached lakehouse
+        or if no lakehouse attached, resolves to the workspace of the notebook.
+    """
+
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (dataset_name, dataset_id) = resolve_dataset_name_and_id(
+        dataset=dataset, workspace=workspace_id
+    )
+
+    payload = {
+        "connectionBinding": {
+            "id": str(connection_id),
+            "connectivityType": connectivity_type,
+            "connectionDetails": {
+                "type": connection_type,
+                "path": connection_path,
+            },
+        }
+    }
+
+    _base_api(
+        request=f"/v1/workspaces/{workspace_id}/semanticModels/{dataset_id}/bindConnection",
+        method="post",
+        client="fabric_sp",
+        payload=payload,
+    )
+
+    print(
+        f"{icons.green_dot} Connection '{connection_id}' has been bound to the '{dataset_name}' semantic model within the '{workspace_name}' workspace."
+    )
+
+
+@log
+def unbind_semantic_model_connection(
+    dataset: str | UUID,
+    connection_type: str,
+    connection_path: str,
+    workspace: Optional[str | UUID] = None,
+):
+    """
+    Unbinds a semantic model data source reference to a data connection.
+
+    This is a wrapper function for the following API: `Items - Bind Semantic Model Connection <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/bind-semantic-model-connection>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    dataset : str | uuid.UUID
+        Name or ID of the semantic model.
+    connection_type : str
+        The `type <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/bind-semantic-model-connection?tabs=HTTP#connectivitytype>`_ of the connection.
+    connection_path : str
+        The path of the connection.
+    workspace : str | uuid.UUID, default=None
+        The workspace name or ID.
+        Defaults to None which resolves to the workspace of the attached lakehouse
+        or if no lakehouse attached, resolves to the workspace of the notebook.
+    """
+
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (dataset_name, dataset_id) = resolve_dataset_name_and_id(
+        dataset=dataset, workspace=workspace_id
+    )
+
+    payload = {
+        "connectionBinding": {
+            "connectivityType": "None",
+            "connectionDetails": {
+                "type": connection_type,
+                "path": connection_path,
+            },
+        }
+    }
+
+    _base_api(
+        request=f"/v1/workspaces/{workspace_id}/semanticModels/{dataset_id}/bindConnection",
+        method="post",
+        client="fabric_sp",
+        payload=payload,
+    )
+
+    print(
+        f"{icons.green_dot} The '{dataset_name}' semantic model within the '{workspace_name}' workspace has been unbound from its connection."
+    )

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/src/sempy_labs/_sql_endpoints.py

@@ -66,7 +66,8 @@ def refresh_sql_endpoint_metadata(
     item: str | UUID,
     type: Literal["Lakehouse", "MirroredDatabase"],
     workspace: Optional[str | UUID] = None,
-    tables: dict[str, list[str]] = None,
+    timeout_unit: Literal["Seconds", "Minutes", "Hours", "Days"] = "Minutes",
+    timeout_value: int = 15,
 ) -> pd.DataFrame:
     """
     Refreshes the metadata of a SQL endpoint.
@@ -85,15 +86,10 @@ def refresh_sql_endpoint_metadata(
         The Fabric workspace name or ID.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
-    tables : dict[str, list[str]], default=None
-        A dictionary where the keys are schema names and the values are lists of table names.
-        If empty, all table metadata will be refreshed.
-
-        Example:
-        {
-            "dbo": ["DimDate", "DimGeography"],
-            "sls": ["FactSales", "FactBudget"],
-        }
+    timeout_unit : Literal['Seconds', 'Minutes', 'Hours', 'Days'], default='Minutes'
+        The unit of time for the request duration before timing out. Additional duration types may be added over time.
+    timeout_value : int, default=15
+        The number of time units in the request duration.
 
     Returns
     -------
@@ -132,14 +128,10 @@ def refresh_sql_endpoint_metadata(
     else:
         raise ValueError("Invalid type. Must be 'Lakehouse' or 'MirroredDatabase'.")
 
-    payload = {}
-    if tables:
-        payload = {
-            "tableDefinitions": [
-                {"schema": schema, "tableNames": tables}
-                for schema, tables in tables.items()
-            ]
-        }
+    payload = None
+    timeout_unit = timeout_unit.capitalize()
+    if timeout_unit != "Minutes" and timeout_value != 15:
+        payload = {"timeout": {"timeUnit": timeout_unit, "value": timeout_value}}
 
     result = _base_api(
         request=f"v1/workspaces/{workspace_id}/sqlEndpoints/{sql_endpoint_id}/refreshMetadata",
@@ -195,10 +187,8 @@ def refresh_sql_endpoint_metadata(
         df = df[column_order]
 
         printout = f"{icons.green_dot} The metadata of the SQL endpoint for the '{item_name}' {type.lower()} within the '{workspace_name}' workspace has been refreshed"
-        if tables:
-            print(f"{printout} for the following tables: {tables}.")
-        else:
-            print(f"{printout} for all tables.")
+        print(f"{printout} for all tables.")
+        _update_dataframe_datatypes(df, columns)
     else:
         # If the target item has no tables to refresh the metadata for
         df = pd.DataFrame(columns=columns.keys())
@@ -206,6 +196,4 @@ def refresh_sql_endpoint_metadata(
             f"{icons.yellow_dot} The SQL endpoint '{item_name}' {type.lower()} within the '{workspace_name}' workspace has no tables to refresh..."
         )
 
-    _update_dataframe_datatypes(df, columns)
-
     return df

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/src/sempy_labs/_warehouses.py

@@ -1,5 +1,4 @@
-from ._helper_functions import (
-    resolve_item_id,
+from sempy_labs._helper_functions import (
     resolve_workspace_name_and_id,
     _base_api,
     _create_dataframe,
@@ -233,57 +232,3 @@ def get_warehouse_columns(
         )
 
     return df
-
-
-@log
-def get_warehouse_connection_string(
-    warehouse: str | UUID,
-    workspace: Optional[str | UUID] = None,
-    guest_tenant_id: Optional[UUID] = None,
-    private_link_type: Optional[str] = None,
-) -> str:
-    """
-    Returns the SQL connection string of the specified warehouse.
-
-    Parameters
-    ----------
-    warehouse : str | uuid.UUID
-        Name or ID of the Fabric warehouse.
-    workspace : str | uuid.UUID, default=None
-        The Fabric workspace name or ID.
-        Defaults to None which resolves to the workspace of the attached lakehouse
-        or if no lakehouse attached, resolves to the workspace of the notebook.
-    guest_tenant_id : uuid.UUID, default=None
-        The guest tenant ID if the end user's tenant is different from the warehouse tenant.
-    private_link_type : str, default=None
-        Indicates the type of private link this connection string uses. Must be either 'Workspace' or 'None' or left as None.
-
-    Returns
-    -------
-    str
-        Returns the SQL connection string of the specified warehouse.
-    """
-    workspace_id = resolve_workspace_id(workspace)
-    warehouse_id = resolve_item_id(
-        item=warehouse, type="Warehouse", workspace=workspace
-    )
-
-    url = f"/v1/workspaces/{workspace_id}/warehouses/{warehouse_id}/connectionString"
-
-    if private_link_type is not None and private_link_type not in ["Workspace", "None"]:
-        raise ValueError(
-            f"{icons.red_dot} private_link_type must be 'Workspace' or 'None' or left as None."
-        )
-
-    if guest_tenant_id or private_link_type:
-        params = []
-        if guest_tenant_id:
-            params.append(f"guestTenantId={guest_tenant_id}")
-        if private_link_type:
-            params.append(f"privateLinkType={private_link_type}")
-        param_str = "?" + "&".join(params)
-        url += param_str
-
-    response = _base_api(request=url, client="fabric_sp")
-
-    return response.json().get("connectionString")

{semantic_link_labs-0.12.2 → semantic_link_labs-0.12.3}/src/sempy_labs/graph/__init__.py

@@ -22,6 +22,9 @@ from ._users import (
 from ._teams import (
     list_teams,
 )
+from ._sensitivity_labels import (
+    list_sensitivity_labels,
+)
 
 __all__ = [
     "list_groups",
@@ -42,4 +45,5 @@ __all__ = [
     "delete_group",
     "update_user",
     "update_group",
+    "list_sensitivity_labels",
 ]

semantic_link_labs-0.12.3/src/sempy_labs/graph/_sensitivity_labels.py

@@ -0,0 +1,81 @@
+import pandas as pd
+from uuid import UUID
+from typing import Optional
+from sempy_labs._helper_functions import (
+    _base_api,
+    _create_dataframe,
+    _update_dataframe_datatypes,
+)
+from sempy._utils._log import log
+
+
+@log
+def list_sensitivity_labels(user: Optional[str | UUID] = None) -> pd.DataFrame:
+    """
+    Get a list of `sensitivity label <https://learn.microsoft.com/graph/api/resources/security-sensitivitylabel>`_ objects associated with a user or organization.
+
+    This is a wrapper function for the following API: `List sensitivityLabels https://learn.microsoft.com/graph/api/security-informationprotection-list-sensitivitylabels>`_.
+
+    Service Principal Authentication is required (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    user : str | uuid.UUID
+        The user ID or user principal name.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of `sensitivity label <https://learn.microsoft.com/graph/api/resources/security-sensitivitylabel>`_ objects associated with a user or organization.
+    """
+    from sempy_labs.graph import resolve_user_id
+
+    url = "/security/informationProtection/sensitivityLabels"
+
+    if user is not None:
+        user_id = resolve_user_id(user=user)
+        url = f"users/{user_id}{url}"
+
+    result = _base_api(request=url, client="graph").json()
+
+    columns = {
+        "Sensitivity Label Id": "str",
+        "Sensitivity Label Name": "str",
+        "Description": "str",
+        "Color": "str",
+        "Sensitivity": "int",
+        "Tooltip": "str",
+        "Is Active": "bool",
+        "Is Appliable": "bool",
+        "Has Protection": "bool",
+        "Parent Sensitivity Label Id": "str",
+        "Parent Sensitivity Label Name": "str",
+    }
+    df = _create_dataframe(columns=columns)
+
+    rows = []
+    for item in result.get("value", []):
+        row = {
+            "Sensitivity Label Id": item.get("id"),
+            "Sensitivity Label Name": item.get("name"),
+            "Description": item.get("description"),
+            "Color": item.get("color"),
+            "Sensitivity": item.get("sensitivity"),
+            "Tooltip": item.get("tooltip"),
+            "Is Active": item.get("isActive"),
+            "Is Appliable": item.get("isAppliable"),
+            "Has Protection": item.get("hasProtection"),
+            "Parent Sensitivity Label Id": (
+                item.get("parent", {}).get("id") if item.get("parent") else None
+            ),
+            "Parent Sensitivity Label Name": (
+                item.get("parent", {}).get("name") if item.get("parent") else None
+            ),
+        }
+        rows.append(row)
+
+    if rows:
+        df = pd.DataFrame(rows, columns=list(columns.keys()))
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df