Tenants overview (#28676)

* Tenants overview

* Updates

* Updates + add more images

* Add overview to TOC

* Refreshed icons

* Update reference TOC

* Updates

* updates

---------

Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>

Author: FaithOmbongi

api-reference/beta/resources/tenants-overview.md

@@ -0,0 +1,23 @@
+---
+title: "Overview of tenant management APIs in Microsoft Graph"
+description: "Use Microsoft Graph tenant management APIs to configure, govern, and protect tenants at scale."
+author: "FaithOmbongi"
+ms.author: "ombongifaith"
+ms.localizationpriority: high
+doc_type: conceptualPageType
+ms.subservice: "entra-directory-management"
+ms.topic: overview
+ms.date: 04/17/2026
+# Customer intent: As a developer integrating with Microsoft Graph, I want to know which tenant management APIs are available so I can choose the right APIs to programmatically manage my organization's tenant configurations and governance at scale.
+---
+
+# Overview of tenant management APIs in Microsoft Graph
+
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+
+Tenants are the foundation of your organization's cloud environment, providing the boundaries for collaboration, identity, access, and resource management. Microsoft Graph provides a growing set of APIs to programmatically manage, configure, and govern those tenants at scale - from maintaining consistent settings to establishing cross-tenant governance relationships.
+
+## Available services and APIs
+
+
+[!INCLUDE [tenant-management-overview](../../includes/tenant-management-overview.md)]

api-reference/beta/toc.yml

@@ -114,6 +114,7 @@ items:
     displayName: Microsoft Teams
   - name: Tenants
     href: toc/tenants/toc.yml
+    displayName: tenant management, tenant configuration, tenant governance, Lighhouse, cross-tenant access, multitenant, backup
   - name: To-do tasks
     href: toc/to-do-tasks/toc.yml
     displayName: Microsoft To Do

api-reference/beta/toc/tenants/toc.yml

@@ -2,6 +2,8 @@
 # GENERATED FILE - DO NOT EDIT
 #
 items:
+- name: Overview
+  href: ../../resources/tenants-overview.md
 - name: Configuration management
   items:
   - name: Overview

api-reference/beta/toc/toc.mapping.json

@@ -3679,6 +3679,16 @@
     {
       "name": "Tenants",
       "shouldSort": true,
+      "overview": "../../resources/tenants-overview.md",
+      "keywords": [
+        "tenant management",
+        "tenant configuration",
+        "tenant governance",
+        "Lighhouse",
+        "cross-tenant access",
+        "multitenant",
+        "backup"
+      ],
       "childNodes": [
         {
           "name": "Configuration management",

api-reference/includes/tenant-management-overview.md

@@ -0,0 +1,36 @@
+---
+title: Manage your tenants by using Microsoft Graph
+description: Manage your tenants by using Microsoft Graph
+author: FaithOmbongi
+ms.author: ombongifaith
+ms.date: 04/17/2026
+ms.topic: include
+ms.subservice: non-product-specific
+---
+
+---
+:::image type="icon" source="/graph/images/tenants/configuration-icon.svg" alt-text="" border="false":::
+
+### [Configuration management](/graph/api/resources/unified-tenant-configuration-management-api-overview)
+
+Define a baseline of your tenant configuration settings and monitor them over time. Detect and resolve configuration drift across workloads such as conditional access policies, security defaults, and identity providers.
+
+---
+
+:::image type="icon" source="/graph/images/tenants/governance-icon.svg" alt-text="" border="false":::
+
+### [Governance](/graph/api/resources/tenantgovernanceservices-tenantgovernance-overview)
+
+Discover related tenants and establish governance relationships at scale. Configure cross-tenant delegated administration, manage multi-tenant applications across governed tenants, and enforce consistent governance policies.
+
+:::image type="content" source="/graph/images/preview-label.png" alt-text="Available on beta only.":::
+
+---
+
+<!--
+ICON GUIDELINES
+===============
+- Add a square icon (~100x100px PNG) to /api-reference/beta/media/icons/
+- Use the naming convention: tenants-<category>.png
+- icon type images do not need alt text (leave alt-text="" )
+-->