Merge pull request #995 from KelvinTegelaar/dev

[pull] dev from KelvinTegelaar:dev

Author: pull[bot]

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListAdminPortalLicenses.ps1

@@ -4,6 +4,8 @@ function Invoke-ListAdminPortalLicenses {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Retrieves license information from the Microsoft 365 Admin Portal for a tenant, including low-friction trial allotments.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListApiTest.ps1

@@ -4,6 +4,8 @@ function Invoke-ListApiTest {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Returns debug information about the current API request, trigger metadata, and environment variables. Used for CIPP platform diagnostics.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListCustomDataMappings.ps1

@@ -4,6 +4,8 @@ function Invoke-ListCustomDataMappings {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Lists custom data mappings that define how external data sources map to CIPP directory objects, filterable by source type, directory object, and tenant.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListDiagnosticsPresets.ps1

@@ -4,6 +4,8 @@ function Invoke-ListDiagnosticsPresets {
         Entrypoint
     .ROLE
         CIPP.SuperAdmin.Read
+    .DESCRIPTION
+        Lists saved diagnostics presets used for troubleshooting CIPP configuration. Requires SuperAdmin access.
     #>
     [CmdletBinding()]
     param (

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListDirectoryObjects.ps1

@@ -4,6 +4,8 @@ function Invoke-ListDirectoryObjects {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Resolves Entra ID directory objects by their IDs using the directoryObjects/getByIds batch endpoint. Accepts an array of object IDs in the request body.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListFeatureFlags.ps1

@@ -4,6 +4,8 @@ function Invoke-ListFeatureFlags {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Lists CIPP feature flags and their enabled/disabled state, including environment-driven overrides.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListGraphBulkRequest.ps1

@@ -4,6 +4,8 @@ function Invoke-ListGraphBulkRequest {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Executes multiple Microsoft Graph API requests in a single batch call for a given tenant. Accepts an array of request objects in the body.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListGraphRequest.ps1

@@ -5,6 +5,8 @@ function Invoke-ListGraphRequest {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Proxies an arbitrary Microsoft Graph API GET request for a tenant. Supports custom endpoints, filters, pagination, and field selection via query parameters.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListSnoozedAlerts.ps1

@@ -4,6 +4,8 @@ function Invoke-ListSnoozedAlerts {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Alert.Read
+    .DESCRIPTION
+        Lists alerts that have been snoozed (temporarily suppressed), filterable by cmdlet name. Returns snooze duration and scope details.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/invoke-ListEmptyResults.ps1

@@ -8,6 +8,8 @@ function invoke-ListEmptyResults {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Returns an empty results array. Used as a placeholder endpoint.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)