Updated to Controllers/Document controllers (#20917)

OwainWilliams · web-flow · commit 8918d49c15ea · 2025-11-26T10:51:12.000+01:00
* [ADD] Cultures Summary and Description

* tidy up from previous merge issue

* update wording on notifications controller

* UpdateDomainsController wording update

* Update the UpdateNotificationsController description / summary

* UpdatePublicAccessDocumentController update

* naming Document Blueprint as referenced in the Docs

* renaming Document Blueprint to match Group Name

* Document Blueprint updates

* Document Type Folder controllers

* Document Type Item endpoints
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/Culture/AllCultureController.cs b/src/Umbraco.Cms.Api.Management/Controllers/Culture/AllCultureController.cs
@@ -21,10 +21,6 @@ public AllCultureController(IUmbracoMapper umbracoMapper, ICultureService cultur
         _cultureService = cultureService;
     }
 
-    /// <summary>
-    ///     Returns all cultures available for creating languages.
-    /// </summary>
-    /// <returns></returns>
     [HttpGet]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PagedViewModel<CultureReponseModel>), StatusCodes.Status200OK)]
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/Document/NotificationsController.cs b/src/Umbraco.Cms.Api.Management/Controllers/Document/NotificationsController.cs
@@ -36,7 +36,7 @@ public NotificationsController(
     [ProducesResponseType(typeof(IEnumerable<DocumentNotificationResponseModel>), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [EndpointSummary("Gets notifications for a document.")]
-    [EndpointDescription("Gets the notification settings for the document identified by the provided Id.")]
+    [EndpointDescription("Gets the notifications for the document identified by the provided Id.")]
     public async Task<IActionResult> Notifications(CancellationToken cancellationToken, Guid id)
     {
         AuthorizationResult authorizationResult = await _authorizationService.AuthorizeResourceAsync(
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/Document/UpdateDomainsController.cs b/src/Umbraco.Cms.Api.Management/Controllers/Document/UpdateDomainsController.cs
@@ -32,8 +32,8 @@ public UpdateDomainsController(IDomainService domainService, IUmbracoMapper umbr
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status409Conflict)]
-    [EndpointSummary("Updates a document.")]
-    [EndpointDescription("Updates a document identified by the provided Id with the details from the request model.")]
+    [EndpointSummary("Updates the domains for a document.")]
+    [EndpointDescription("Updates the domains for the document identified by the provided Id with the details from the request model.")]
     public async Task<IActionResult> Update(
         CancellationToken cancellationToken,
         Guid id,
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/Document/UpdateNotificationsController.cs b/src/Umbraco.Cms.Api.Management/Controllers/Document/UpdateNotificationsController.cs
@@ -26,8 +26,8 @@ public UpdateNotificationsController(IContentEditingService contentEditingServic
     [HttpPut("{id:guid}/notifications")]
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Updates a document.")]
-    [EndpointDescription("Updates a document identified by the provided Id with the details from the request model.")]
+    [EndpointSummary("Updates notification subscriptions for a document.")]
+    [EndpointDescription("Updates which actions the current user is subscribed to receive notifications for on the specified document.")]
     public async Task<IActionResult> UpdateNotifications(CancellationToken cancellationToken, Guid id, UpdateDocumentNotificationsRequestModel updateModel)
     {
         IContent? content = await _contentEditingService.GetAsync(id);
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/Document/UpdatePublicAccessDocumentController.cs b/src/Umbraco.Cms.Api.Management/Controllers/Document/UpdatePublicAccessDocumentController.cs
@@ -37,8 +37,8 @@ public UpdatePublicAccessDocumentController(
     [MapToApiVersion("1.0")]
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Updates a document.")]
-    [EndpointDescription("Updates a document identified by the provided Id with the details from the request model.")]
+    [EndpointSummary("Updates public access protection for a document.")]
+    [EndpointDescription("Updates the member protection settings for a document, controlling which members or member groups can access it.")]
     public async Task<IActionResult> Update(CancellationToken cancellationToken, Guid id, PublicAccessRequestModel requestModel)
     {
         AuthorizationResult authorizationResult = await _authorizationService.AuthorizeResourceAsync(
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/ByKeyDocumentBlueprintController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/ByKeyDocumentBlueprintController.cs
@@ -27,8 +27,8 @@ public ByKeyDocumentBlueprintController(IContentBlueprintEditingService contentB
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(DocumentBlueprintResponseModel), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Gets a document blueprint.")]
-    [EndpointDescription("Gets a document blueprint identified by the provided Id.")]
+    [EndpointSummary("Gets a Document Blueprint.")]
+    [EndpointDescription("Gets a Document Blueprint identified by the provided Id.")]
     public async Task<IActionResult> ByKey(CancellationToken cancellationToken, Guid id)
     {
         IContent? blueprint = await _contentBlueprintEditingService.GetAsync(id);
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/CreateDocumentBlueprintController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/CreateDocumentBlueprintController.cs
@@ -36,8 +36,8 @@ public CreateDocumentBlueprintController(
     [ProducesResponseType(StatusCodes.Status201Created)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Creates a new documentblueprint.")]
-    [EndpointDescription("Creates a new documentblueprint with the configuration specified in the request model.")]
+    [EndpointSummary("Creates a new Document Blueprint.")]
+    [EndpointDescription("Creates a new Document Blueprint with the configuration specified in the request model.")]
     public async Task<IActionResult> Create(CancellationToken cancellationToken, CreateDocumentBlueprintRequestModel requestModel)
     {
         ContentBlueprintCreateModel model = _blueprintEditingPresentationFactory.MapCreateModel(requestModel);
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/CreateDocumentBlueprintFromDocumentController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/CreateDocumentBlueprintFromDocumentController.cs
@@ -40,8 +40,8 @@ public CreateDocumentBlueprintFromDocumentController(
     [MapToApiVersion("1.0")]
     [ProducesResponseType(StatusCodes.Status201Created)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Creates a document blueprint from an existing document.")]
-    [EndpointDescription("Creates a new document blueprint based on an existing document identified by the provided Id.")]
+    [EndpointSummary("Creates a Document Blueprint from an existing document.")]
+    [EndpointDescription("Creates a new Document Blueprint based on an existing document identified by the provided Id.")]
     public async Task<IActionResult> CreateFromDocument(CancellationToken cancellationToken, CreateDocumentBlueprintFromDocumentRequestModel fromDocumentRequestModel)
     {
         AuthorizationResult authorizationResult = await _authorizationService.AuthorizeResourceAsync(
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/DeleteDocumentBlueprintController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/DeleteDocumentBlueprintController.cs
@@ -29,8 +29,8 @@ public DeleteDocumentBlueprintController(IContentBlueprintEditingService content
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Deletes a document blueprint.")]
-    [EndpointDescription("Deletes a document blueprint identified by the provided Id.")]
+    [EndpointSummary("Deletes a Document Blueprint.")]
+    [EndpointDescription("Deletes a Document Blueprint identified by the provided Id.")]
     public async Task<IActionResult> Delete(CancellationToken cancellationToken, Guid id)
     {
         Attempt<IContent?, ContentEditingOperationStatus> result = await _contentBlueprintEditingService.DeleteAsync(id, CurrentUserKey(_backOfficeSecurityAccessor));
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/DocumentBlueprintControllerBase.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/DocumentBlueprintControllerBase.cs
@@ -13,6 +13,6 @@ public abstract class DocumentBlueprintControllerBase : ContentControllerBase
     protected IActionResult DocumentBlueprintNotFound()
         => OperationStatusResult(ContentEditingOperationStatus.NotFound, problemDetailsBuilder
             => NotFound(problemDetailsBuilder
-                .WithTitle("The document blueprint could not be found")
+                .WithTitle("The Document Blueprint could not be found")
                 .Build()));
 }
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Folder/CreateDocumentBlueprintFolderController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Folder/CreateDocumentBlueprintFolderController.cs
@@ -22,8 +22,8 @@ public CreateDocumentBlueprintFolderController(
     [ProducesResponseType(StatusCodes.Status201Created)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Creates a documentblueprint folder.")]
-    [EndpointDescription("Creates a new documentblueprint folder with the provided name and parent location.")]
+    [EndpointSummary("Creates a Document Blueprint folder.")]
+    [EndpointDescription("Creates a new Document Blueprint folder with the provided name and parent location.")]
     public async Task<IActionResult> Create(CancellationToken cancellationToken, CreateFolderRequestModel createFolderRequestModel)
         => await CreateFolderAsync<ByKeyDocumentBlueprintFolderController>(
             createFolderRequestModel,
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Folder/DeleteDocumentBlueprintFolderController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Folder/DeleteDocumentBlueprintFolderController.cs
@@ -21,7 +21,7 @@ public DeleteDocumentBlueprintFolderController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Deletes a document blueprint folder.")]
-    [EndpointDescription("Deletes a document blueprint folder identified by the provided Id.")]
+    [EndpointSummary("Deletes a Document Blueprint folder.")]
+    [EndpointDescription("Deletes a Document Blueprint folder identified by the provided Id.")]
     public async Task<IActionResult> Delete(CancellationToken cancellationToken, Guid id) => await DeleteFolderAsync(id);
 }
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Folder/UpdateDocumentBlueprintFolderController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Folder/UpdateDocumentBlueprintFolderController.cs
@@ -22,8 +22,8 @@ public UpdateDocumentBlueprintFolderController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Updates a document blueprint folder.")]
-    [EndpointDescription("Updates a document blueprint folder identified by the provided Id with the details from the request model.")]
+    [EndpointSummary("Updates a Document Blueprint folder.")]
+    [EndpointDescription("Updates a Document Blueprint folder identified by the provided Id with the details from the request model.")]
     public async Task<IActionResult> Update(CancellationToken cancellationToken, Guid id, UpdateFolderResponseModel updateFolderResponseModel)
         => await UpdateFolderAsync(id, updateFolderResponseModel);
 }
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Item/ItemDocumentBlueprintController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Item/ItemDocumentBlueprintController.cs
@@ -25,8 +25,8 @@ public ItemDocumentBlueprintController(IEntityService entityService, IDocumentPr
     [HttpGet]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<DocumentBlueprintItemResponseModel>), StatusCodes.Status200OK)]
-    [EndpointSummary("Gets a collection of document blueprint items.")]
-    [EndpointDescription("Gets a collection of document blueprint items identified by the provided Ids.")]
+    [EndpointSummary("Gets a collection of Document Blueprint items.")]
+    [EndpointDescription("Gets a collection of Document Blueprint items identified by the provided Ids.")]
     public Task<IActionResult> Item(
         CancellationToken cancellationToken,
         [FromQuery(Name = "id")] HashSet<Guid> ids)
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/MoveDocumentBlueprintController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/MoveDocumentBlueprintController.cs
@@ -28,8 +28,8 @@ public MoveDocumentBlueprintController(IContentBlueprintEditingService contentBl
     [MapToApiVersion("1.0")]
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Moves a document blueprint.")]
-    [EndpointDescription("Moves a document blueprint identified by the provided Id to a different location.")]
+    [EndpointSummary("Moves a Document Blueprint.")]
+    [EndpointDescription("Moves a Document Blueprint identified by the provided Id to a different location.")]
     public async Task<IActionResult> Move(CancellationToken cancellationToken, Guid id, MoveDocumentBlueprintRequestModel requestModel)
     {
         Attempt<ContentEditingOperationStatus> result = await _contentBlueprintEditingService.MoveAsync(id, requestModel.Target?.Id, CurrentUserKey(_backOfficeSecurityAccessor));
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/ScaffoldDocumentBlueprintController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/ScaffoldDocumentBlueprintController.cs
@@ -27,8 +27,8 @@ public ScaffoldDocumentBlueprintController(IContentBlueprintEditingService conte
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(DocumentBlueprintResponseModel), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Scaffolds a document blueprint.")]
-    [EndpointDescription("Creates a scaffold for a new document blueprint with default values.")]
+    [EndpointSummary("Scaffolds a Document Blueprint.")]
+    [EndpointDescription("Creates a scaffold for a new Document Blueprint with default values.")]
     public async Task<IActionResult> Scaffold(CancellationToken cancellationToken, Guid id)
     {
         IContent? blueprint = await _contentBlueprintEditingService.GetScaffoldedAsync(id);
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/AncestorsDocumentBlueprintTreeController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/AncestorsDocumentBlueprintTreeController.cs
@@ -27,8 +27,8 @@ public AncestorsDocumentBlueprintTreeController(IEntityService entityService, Fl
     [HttpGet("ancestors")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<DocumentBlueprintTreeItemResponseModel>), StatusCodes.Status200OK)]
-    [EndpointSummary("Gets a collection of ancestor document blueprint items.")]
-    [EndpointDescription("Gets a collection of document blueprint items that are ancestors to the provided Id.")]
+    [EndpointSummary("Gets a collection of ancestor Document Blueprint items.")]
+    [EndpointDescription("Gets a collection of Document Blueprint items that are ancestors to the provided Id.")]
     public async Task<ActionResult<IEnumerable<DocumentBlueprintTreeItemResponseModel>>> Ancestors(CancellationToken cancellationToken, Guid descendantId)
         => await GetAncestors(descendantId);
 }
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/ChildrenDocumentBlueprintTreeController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/ChildrenDocumentBlueprintTreeController.cs
@@ -28,8 +28,8 @@ public ChildrenDocumentBlueprintTreeController(IEntityService entityService, Fla
     [HttpGet("children")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PagedViewModel<DocumentBlueprintTreeItemResponseModel>), StatusCodes.Status200OK)]
-    [EndpointSummary("Gets a collection of document blueprint tree child items.")]
-    [EndpointDescription("Gets a paginated collection of document blueprint tree items that are children of the provided parent Id.")]
+    [EndpointSummary("Gets a collection of Document Blueprint tree child items.")]
+    [EndpointDescription("Gets a paginated collection of Document Blueprint tree items that are children of the provided parent Id.")]
     public async Task<ActionResult<PagedViewModel<DocumentBlueprintTreeItemResponseModel>>> Children(CancellationToken cancellationToken, Guid parentId, int skip = 0, int take = 100, bool foldersOnly = false)
     {
         RenderFoldersOnly(foldersOnly);
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/RootDocumentBlueprintTreeController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/RootDocumentBlueprintTreeController.cs
@@ -28,8 +28,8 @@ public RootDocumentBlueprintTreeController(IEntityService entityService, FlagPro
     [HttpGet("root")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PagedViewModel<DocumentBlueprintTreeItemResponseModel>), StatusCodes.Status200OK)]
-    [EndpointSummary("Gets a collection of document blueprint items from the root of the tree.")]
-    [EndpointDescription("Gets a paginated collection of document blueprint items from the root of the tree with optional filtering.")]
+    [EndpointSummary("Gets a collection of Document Blueprint items from the root of the tree.")]
+    [EndpointDescription("Gets a paginated collection of Document Blueprint items from the root of the tree with optional filtering.")]
     public async Task<ActionResult<PagedViewModel<DocumentBlueprintTreeItemResponseModel>>> Root(
         CancellationToken cancellationToken,
         int skip = 0,
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/SiblingsDocumentBlueprintTreeController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/SiblingsDocumentBlueprintTreeController.cs
@@ -25,8 +25,8 @@ public SiblingsDocumentBlueprintTreeController(IEntityService entityService, Fla
 
     [HttpGet("siblings")]
     [ProducesResponseType(typeof(SubsetViewModel<DocumentBlueprintTreeItemResponseModel>), StatusCodes.Status200OK)]
-    [EndpointSummary("Gets a collection of document blueprint tree sibling items.")]
-    [EndpointDescription("Gets a collection of document blueprint tree items that are siblings of the provided Id.")]
+    [EndpointSummary("Gets a collection of Document Blueprint tree sibling items.")]
+    [EndpointDescription("Gets a collection of Document Blueprint tree items that are siblings of the provided Id.")]
     public async Task<ActionResult<SubsetViewModel<DocumentBlueprintTreeItemResponseModel>>> Siblings(
         CancellationToken cancellationToken,
         Guid target,
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/UpdateDocumentBlueprintController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/UpdateDocumentBlueprintController.cs
@@ -36,8 +36,8 @@ public UpdateDocumentBlueprintController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Updates a document blueprint.")]
-    [EndpointDescription("Updates a document blueprint identified by the provided Id with the details from the request model.")]
+    [EndpointSummary("Updates a Document Blueprint.")]
+    [EndpointDescription("Updates a Document Blueprint identified by the provided Id with the details from the request model.")]
     public async Task<IActionResult> Update(CancellationToken cancellationToken, Guid id, UpdateDocumentBlueprintRequestModel requestModel)
     {
         ContentBlueprintUpdateModel model = _blueprintEditingPresentationFactory.MapUpdateModel(requestModel);
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/ByKeyDocumentTypeFolderController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/ByKeyDocumentTypeFolderController.cs
@@ -21,7 +21,7 @@ public ByKeyDocumentTypeFolderController(
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(FolderResponseModel), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Gets a document type folder.")]
-    [EndpointDescription("Gets a document type folder identified by the provided Id.")]
+    [EndpointSummary("Gets a Document Type folder.")]
+    [EndpointDescription("Gets a Document Type folder identified by the provided Id.")]
     public async Task<IActionResult> ByKey(CancellationToken cancellationToken, Guid id) => await GetFolderAsync(id);
 }
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/CreateDocumentTypeFolderController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/CreateDocumentTypeFolderController.cs
@@ -22,8 +22,8 @@ public CreateDocumentTypeFolderController(
     [ProducesResponseType(StatusCodes.Status201Created)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Creates a document type folder.")]
-    [EndpointDescription("Creates a new document type folder with the provided name and parent location.")]
+    [EndpointSummary("Creates a Document Type folder.")]
+    [EndpointDescription("Creates a new Document Type folder with the provided name and parent location.")]
     public async Task<IActionResult> Create(
         CancellationToken cancellationToken,
         CreateFolderRequestModel createFolderRequestModel)
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/DeleteDocumentTypeFolderController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/DeleteDocumentTypeFolderController.cs
@@ -21,7 +21,7 @@ public DeleteDocumentTypeFolderController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Deletes a document type folder.")]
-    [EndpointDescription("Deletes a document type folder identified by the provided Id.")]
+    [EndpointSummary("Deletes a Document Type folder.")]
+    [EndpointDescription("Deletes a Document Type folder identified by the provided Id.")]
     public async Task<IActionResult> Delete(CancellationToken cancellationToken, Guid id) => await DeleteFolderAsync(id);
 }
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/UpdateDocumentTypeFolderController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/UpdateDocumentTypeFolderController.cs
@@ -22,8 +22,8 @@ public UpdateDocumentTypeFolderController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Updates a document type folder.")]
-    [EndpointDescription("Updates a document type folder identified by the provided Id with the details from the request model.")]
+    [EndpointSummary("Updates a Document Type folder.")]
+    [EndpointDescription("Updates a Document Type folder identified by the provided Id with the details from the request model.")]
     public async Task<IActionResult> Update(
         CancellationToken cancellationToken,
         Guid id,
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Item/ItemDocumentTypeItemController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Item/ItemDocumentTypeItemController.cs
diff --git a/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Item/SearchDocumentTypeItemController.cs b/src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Item/SearchDocumentTypeItemController.cs

Original file line number	Diff line number	Diff line change
`@@ -36,7 +36,7 @@ public NotificationsController(`
`36`	`36`	`[ProducesResponseType(typeof(IEnumerable<DocumentNotificationResponseModel>), StatusCodes.Status200OK)]`
`37`	`37`	`[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]`
`38`	`38`	`[EndpointSummary("Gets notifications for a document.")]`
`39`		`- [EndpointDescription("Gets the notification settings for the document identified by the provided Id.")]`
	`39`	`+ [EndpointDescription("Gets the notifications for the document identified by the provided Id.")]`
`40`	`40`	`public async Task<IActionResult> Notifications(CancellationToken cancellationToken, Guid id)`
`41`	`41`	`{`
`42`	`42`	`AuthorizationResult authorizationResult = await _authorizationService.AuthorizeResourceAsync(`
Original file line number	Diff line number	Diff line change
`@@ -13,6 +13,6 @@ public abstract class DocumentBlueprintControllerBase : ContentControllerBase`
`13`	`13`	`protected IActionResult DocumentBlueprintNotFound()`
`14`	`14`	`=> OperationStatusResult(ContentEditingOperationStatus.NotFound, problemDetailsBuilder`
`15`	`15`	`=> NotFound(problemDetailsBuilder`
`16`		`- .WithTitle("The document blueprint could not be found")`
	`16`	`+ .WithTitle("The Document Blueprint could not be found")`
`17`	`17`	`.Build()));`
`18`	`18`	`}`