Add endpoint descriptions to final 7 Management API endpoints

Co-authored-by: AndyButland <[email protected]>

Author: Copilot

src/Umbraco.Cms.Api.Management/Controllers/HealthCheck/Group/ByNameHealthCheckGroupController.cs

@@ -31,6 +31,8 @@ public ByNameHealthCheckGroupController(
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [ProducesResponseType(typeof(HealthCheckGroupPresentationModel), StatusCodes.Status200OK)]
+    [EndpointSummary("Gets a health check group by name.")]
+    [EndpointDescription("Gets a health check group and all its associated health checks identified by the provided group name.")]
     public Task<IActionResult> ByName(
         CancellationToken cancellationToken,
         string name)

src/Umbraco.Cms.Api.Management/Controllers/HealthCheck/Group/CheckHealthCheckGroupController.cs

@@ -25,6 +25,8 @@ public CheckHealthCheckGroupController(IHealthCheckGroupPresentationFactory heal
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [ProducesResponseType(typeof(HealthCheckGroupWithResultResponseModel), StatusCodes.Status200OK)]
+    [EndpointSummary("Executes all health checks in a group.")]
+    [EndpointDescription("Runs all health checks in the group identified by the provided name and returns the results.")]
     public async Task<IActionResult> ByNameWithResult(
         CancellationToken cancellationToken,
         string name)

src/Umbraco.Cms.Api.Management/Controllers/Member/References/ReferencedDescendantsMemberController.cs

@@ -32,6 +32,8 @@ public ReferencedDescendantsMemberController(ITrackedReferencesService trackedRe
     [HttpGet("{id:guid}/referenced-descendants")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PagedViewModel<ReferenceByIdModel>), StatusCodes.Status200OK)]
+    [EndpointSummary("Gets a paginated collection of referenced descendant members.")]
+    [EndpointDescription("Gets a paginated collection of descendant members that are referenced in relations for the member identified by the provided Id.")]
     public async Task<ActionResult<PagedViewModel<ReferenceByIdModel>>> ReferencedDescendants(
         CancellationToken cancellationToken,
         Guid id,

src/Umbraco.Cms.Api.Management/Controllers/PartialView/Snippet/ByIdController.cs

@@ -24,6 +24,8 @@ public ByIdController(IPartialViewService partialViewService, IUmbracoMapper umb
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PartialViewSnippetResponseModel), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
+    [EndpointSummary("Gets a partial view snippet.")]
+    [EndpointDescription("Gets a partial view snippet identified by the provided Id.")]
     public async Task<IActionResult> GetById(
         CancellationToken cancellationToken,
         string id)

src/Umbraco.Cms.Api.Management/Controllers/PartialView/Snippet/GetAllController.cs

@@ -25,6 +25,8 @@ public GetAllController(IPartialViewService partialViewService, IUmbracoMapper u
     [HttpGet("snippet")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PagedViewModel<PartialViewSnippetItemResponseModel>), StatusCodes.Status200OK)]
+    [EndpointSummary("Gets a paginated collection of partial view snippets.")]
+    [EndpointDescription("Gets a paginated collection of partial view snippets with support for skip and take pagination.")]
     public async Task<IActionResult> GetAll(CancellationToken cancellationToken, int skip = 0, int take = 100)
     {
         PagedModel<PartialViewSnippetSlim> snippets = await _partialViewService.GetSnippetsAsync(skip, take);

src/Umbraco.Cms.Api.Management/Controllers/Template/Query/ExecuteTemplateQueryController.cs

@@ -46,6 +46,8 @@ public ExecuteTemplateQueryController(
     [HttpPost("execute")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(TemplateQueryResultResponseModel), StatusCodes.Status200OK)]
+    [EndpointSummary("Executes a template query.")]
+    [EndpointDescription("Executes a template query with the provided parameters and returns the matching content results with execution metrics.")]
     public Task<ActionResult<TemplateQueryResultResponseModel>> Execute(
         CancellationToken cancellationToken,
         TemplateQueryExecuteModel query)

src/Umbraco.Cms.Api.Management/Controllers/Template/Query/SettingsTemplateQueryController.cs

@@ -17,6 +17,8 @@ public SettingsTemplateQueryController(IContentTypeService contentTypeService)
     [HttpGet("settings")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(TemplateQuerySettingsResponseModel), StatusCodes.Status200OK)]
+    [EndpointSummary("Gets template query settings.")]
+    [EndpointDescription("Gets the available configuration settings for template queries including document type aliases, properties, and operators.")]
     public Task<ActionResult<TemplateQuerySettingsResponseModel>> Settings(CancellationToken cancellationToken)
     {
         var contentTypeAliases = _contentTypeService