Try and fix pipeline

* update ace-builds from 1.14.0 to 1.15.0

* update eslint from 8.32.0 to 8.33.0

* update jsdom from 21.0.0 to 21.1.0

* update nouislider from 15.6.1 to 15.7.0

.devcontainer/Dockerfile

@@ -22,7 +22,3 @@ RUN if [ "${NODE_VERSION}" != "none" ]; then su vscode -c "umask 0002 && . /usr/
 # https://docs.npmjs.com/cli/v6/using-npm/config#unsafe-perm
 # Default: false if running as root, true otherwise (we are ROOT)
 #RUN npm -g config set user vscode && npm -g config set unsafe-perm
-
-# Generate and trust a local developer certificate for Kestrel
-# This is needed for Kestrel to bind on https
-RUN dotnet dev-certs https --trust

.devcontainer/devcontainer.json

@@ -6,6 +6,7 @@
 	"service": "app",
 	"workspaceFolder": "/workspace",
 	
+	
 	// Set *default* container specific settings.json values on container create.
 	"settings": {		
 		"omnisharp.defaultLaunchSolution": "umbraco.sln",
@@ -13,13 +14,62 @@
 		"omnisharp.enableRoslynAnalyzers": true
 	},
 
+	"features": {
+		// Workaround until the image is updated to include the latest version of .NET Core - .NET7
+		// https://github.com/devcontainers/templates/issues/38#issuecomment-1310803259		
+		"ghcr.io/devcontainers/features/dotnet:1": {
+			"version": "7"
+		},
+
+		// Adds SSH support to the container
+		// Allowing the Github CLI `gh codespace ssh` to work
+		"ghcr.io/devcontainers/features/sshd:1": {
+			"version": "latest"
+		},
+
+		// Adds SQLite feature from apt install
+		// Also adds the SQLite VSCode extension
+		"ghcr.io/warrenbuckley/codespace-features/sqlite:1": {}
+	},
+
 	// Add the IDs of extensions you want installed when the container is created.
 	"extensions": [
 		"ms-dotnettools.csharp"
 	],
+	
+	// This is used in the prebuilds - so dotnet build (nuget restore and node stuff) is done
+	"updateContentCommand": "dotnet build umbraco.sln && dotnet dev-certs https --trust",
 
-	// Use 'forwardPorts' to make a list of ports inside the container available locally.
-	"forwardPorts": [9000, 5000, 25]
+	// Use 'forwardPorts' to make a list of ports inside the container available locallAdd	"forwardPorts": [9000, 5000, 25],
+	// Port needed to help discover SMTP4Dev
+	"forwardPorts": [
+		5000
+	],
+
+	"portsAttributes": {
+		"5000": {
+			"label": "SMTP4Dev",
+			"protocol": "http",
+			"onAutoForward": "notify"
+		},
+		"9000": {
+			"label": "Umbraco HTTP",
+			"protocol": "http",
+			"onAutoForward": "notify"
+		},
+		"44331": {
+			"label": "Umbraco HTTPS",
+			"protocol": "https",
+			"onAutoForward": "notify"
+		}
+	},
+	"customizations": {
+		"codespaces": {
+		  "openFiles": [
+			".github/codespaces-readme.md"
+		  ]
+		}
+	}
 
 	// [Optional] To reuse of your local HTTPS dev cert:
 	//

.editorconfig

@@ -248,6 +248,7 @@ csharp_preserve_single_line_blocks = true
 ##########################################
 
 [*.{cs,csx,cake,vb,vbx}]
+dotnet_diagnostic.CS1591.severity = suggestion
 
 ##########################################
 # Styles

.github/BUILD.md

@@ -1,4 +1,4 @@
-# Umbraco CMS Build
+# Umbraco CMS Build
 
 ## Are you sure?
 
@@ -99,111 +99,33 @@ When the page eventually loads in your web browser, you can follow the installer
 
 Did you read ["Are you sure"](#are-you-sure)?
 
-### Quick!
+Do note that this is only required if you want to test out your custom changes in a separate site (not the one in the Umbraco.Web.UI), if you just want to test your changes you can run the included test site using: `dotnet run` from `src/Umbraco.Web.UI/`
 
-To build Umbraco, fire up PowerShell and move to Umbraco's repository root (the directory that contains `src`, `build`, `LICENSE.md`...). There, trigger the build with the following command:
+You may want to build a set of NuGet packages with your changes, this can be done using the dotnet pack command. 
 
-    build/build.ps1
+First enter the root of the project in a command line environment, and then use the following command to build the NuGet packages:
 
-If you only see a build.bat-file, you're probably on the wrong branch. If you switch to the correct branch (v8/contrib) the file will appear and you can build it.
+`dotnet pack -c Release -o Build.Out`
 
-You might run into [Powershell quirks](#powershell-quirks).
+This will restore and build the project using the release configuration, and put all the outputted files in a folder called `Build.Out`
 
-If it runs without errors; Hooray! Now you can continue with [the next step](CONTRIBUTING.md#how-do-i-begin) and open the solution and build it.
+You can then add these as a local NuGet feed using the following command:
 
+`dotnet nuget add source <Path to Build.Out folder> -n MyLocalFeed`
 
-### Build Infrastructure
-
-The Umbraco Build infrastructure relies on a PowerShell object. The object can be retrieved with:
-
-    $ubuild = build/build.ps1 -get
-
-The object exposes various properties and methods that can be used to fine-grain build Umbraco. Some, but not all, of them are detailed below.
-    
-#### Properties
-
-The object exposes the following properties:
-
-* `SolutionRoot`: the absolute path to the solution root
-* `VisualStudio`: a Visual Studio object (see below)
-* `NuGet`: the absolute path to the NuGet executable
-* `Zip`: the absolute path to the 7Zip executable
-* `VsWhere`: the absolute path to the VsWhere executable
-* `NodePath`: the absolute path to the Node install
-* `NpmPath`: the absolute path to the Npm install
-
-The Visual Studio object is `null` when Visual Studio has not been detected (eg on VSTS). When not null, the object exposes the following properties:
-
-* `Path`: Visual Studio installation path (eg some place under `Program Files`)
-* `Major`: Visual Studio major version (eg `15` for VS 2017)
-* `Minor`: Visual Studio minor version
-* `MsBuild`: the absolute path to the MsBuild executable
-
-#### GetUmbracoVersion
-
-Gets an object representing the current Umbraco version. Example:
-
-    $v = $ubuild.GetUmbracoVersion()
-    Write-Host $v.Semver
-
-The object exposes the following properties:
-
-* `Semver`: the semver object representing the version
-* `Release`: the main part of the version (eg `7.6.33`)
-* `Comment`: the pre release part of the version (eg `alpha02`)
-* `Build`: the build number part of the version (eg `1234`)
-
-#### SetUmbracoVersion
-
-Modifies Umbraco files with the new version.
-
->This entirely replaces the legacy `UmbracoVersion.txt` file. Do *not* edit version infos in files.
-
-The version must be a valid semver version. It can include a *pre release* part (eg `alpha02`) and/or a *build number* (eg `1234`). Examples:
-
-    $ubuild.SetUmbracoVersion("7.6.33")
-    $ubuild.SetUmbracoVersion("7.6.33-alpha.2")
-    $ubuild.SetUmbracoVersion("7.6.33+1234")
-    $ubuild.SetUmbracoVersion("7.6.33-beta.5+5678")
-
-#### Build
-
-Builds Umbraco. Temporary files are generated in `build.tmp` while the actual artifacts (zip files, NuGet packages...) are produced in `build.out`. Example:
-
-    $ubuild.Build()
-
-Some log files, such as MsBuild logs, are produced in `build.tmp` too. The `build` directory should remain clean during a build.
-
-**Note: web.config**
-
-Building Umbraco requires a clean `web.config` file in the `Umbraco.Web.UI` project. If a `web.config` file already exists, the `pre-build` task (see below) will save it as `web.config.temp-build` and replace it with a clean copy of `web.Template.config`. The original file is replaced once it is safe to do so, by the `pre-packages` task.
-
-#### Build-UmbracoDocs
-
-Builds umbraco documentation. Temporary files are generated in `build.tmp` while the actual artifacts (docs...) are produced in `build.out`. Example:
-
-    Build-UmbracoDocs
-
-Some log files, such as MsBuild logs, are produced in `build.tmp` too. The `build` directory should remain clean during a build.
-
-#### Verify-NuGet
-
-Verifies that projects all require the same version of their dependencies, and that NuSpec files require versions that are consistent with projects. Example:
-
-    Verify-NuGet
+This will add a local nuget feed with the name "MyLocalFeed" and you'll now be able to use your custom built NuGet packages. 
 
 ### Cleaning up
 
 Once the solution has been used to run a site, one may want to "reset" the solution in order to run a fresh new site again.
 
-At the very minimum, you want
+The easiest way to do this by deleting the following files and folders:
+* src/Umbraco.Web.UI/appsettings.json
+* src/Umbraco.Web.UI/umbraco/Data
 
-    git clean -Xdf src/Umbraco.Web.UI/App_Data
-    rm src/Umbraco.Web.UI/web.config
+You only have to remove the connection strings from the appsettings, but removing the data folder  ensures that the sqlite database gets deleted too.
 
-Then, a simple 'Rebuild All' in Visual Studio will recreate a fresh `web.config` but should be quite fast (since it does not really need to rebuild anything).
-
-The `clean` Git command force (`-f`) removes (`-X`, note the capital X) all files and directories (`-d`) that are ignored by Git.
+Next time you run a build the `appsettings.json` file will be re-created in its default state.
 
 This will leave media files and views around, but in most cases, it will be enough.
 
@@ -219,65 +141,12 @@ For git documentation see:
 
 ## Azure DevOps
 
-Umbraco uses Azure DevOps for continuous integration, nightly builds and release builds. The Umbraco CMS project on DevOps [is available for anonymous users](https://umbraco.visualstudio.com/Umbraco%20Cms).
+Umbraco uses Azure DevOps for continuous integration, nightly builds and release builds. The Umbraco CMS project on DevOps [is available for anonymous users](https://umbraco.visualstudio.com/Umbraco%20Cms)..
 
-DevOps uses the `Build-Umbraco` command several times, each time passing a different *target* parameter. The supported targets are:
-
-* `pre-build`: prepares the build
-* `compile-belle`: compiles Belle
-* `compile-umbraco`: compiles Umbraco
-* `pre-tests`: prepares the tests
-* `compile-tests`: compiles the tests
-* `pre-packages`: prepares the packages
-* `pkg-zip`: creates the zip files
-* `pre-nuget`: prepares NuGet packages
-* `pkg-nuget`: creates NuGet packages
-
-All these targets are executed when `Build-Umbraco` is invoked without a parameter (or with the `all` parameter). On VSTS, compilations (of Umbraco and tests) are performed by dedicated DevOps tasks. Similarly, creating the NuGet packages is also performed by dedicated DevOps tasks.
-
-Finally, the produced artifacts are published in two containers that can be downloaded from DevOps: `zips` contains the zip files while `nuget` contains the NuGet packages.
-
->During a DevOps build, some environment `UMBRACO_*` variables are exported by the `pre-build` target and can be reused in other targets *and* in DevOps tasks. The `UMBRACO_TMP` environment variable is used in `Umbraco.Tests` to disable some tests that have issues with DevOps at the moment.
+The produced artifacts are published in a container that can be downloaded from DevOps called "nupkg" which contains all the NuGet packages that got built.
 
 ## Quirks
 
-### PowerShell Quirks
-
-There is a good chance that running `build.ps1` ends up in error, with messages such as
-
->The file ...\build.ps1 is not digitally signed. You cannot run this script on the current system. For more information about running scripts and setting execution policy, see about_Execution_Policies.
-
-PowerShell has *Execution Policies* that may prevent the script from running. You can check the current policies with:
-
-    PS> Get-ExecutionPolicy -List
-    
-            Scope ExecutionPolicy
-            ----- ---------------
-    MachinePolicy       Undefined
-       UserPolicy       Undefined
-          Process       Undefined
-      CurrentUser       Undefined
-     LocalMachine    RemoteSigned
-
-Policies can be `Restricted`, `AllSigned`, `RemoteSigned`, `Unrestricted` and `Bypass`. Scopes can be `MachinePolicy`, `UserPolicy`, `Process`, `CurrentUser`, `LocalMachine`. You need the current policy to be `RemoteSigned`&mdash;as long as it is `Undefined`, the script cannot run. You can change the current user policy with:
-
-    PS> Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
-
-Alternatively, you can do it at machine level, from within an elevated PowerShell session:
-
-    PS> Set-ExecutionPolicy -Scope LocalMachine -ExecutionPolicy RemoteSigned
-
-And *then* the script should run. It *might* however still complain about executing scripts, with messages such as:
-
->Security warning - Run only scripts that you trust. While scripts from the internet can be useful, this script can potentially harm your computer. If you trust this script, use the Unblock-File cmdlet to allow the script to run without this warning message. Do you want to run ...\build.ps1?
-[D] Do not run  [R] Run once  [S] Suspend  [?] Help (default is "D"):
-
-This is usually caused by the scripts being *blocked*. And that usually happens when the source code has been downloaded as a Zip file. When Windows downloads Zip files, they are marked as *blocked* (technically, they have a Zone.Identifier alternate data stream, with a value of "3" to indicate that they were downloaded from the Internet). And when such a Zip file is un-zipped, each and every single file is also marked as blocked.
-
-The best solution is to unblock the Zip file before un-zipping: right-click the files, open *Properties*, and there should be a *Unblock* checkbox at the bottom of the dialog. If, however, the Zip file has already been un-zipped, it is possible to recursively unblock all files from PowerShell with:
-
-    PS> Get-ChildItem -Recurse *.* | Unblock-File
-
 ### Git Quirks
 
 Git might have issues dealing with long file paths during build. You may want/need to enable `core.longpaths` support (see [this page](https://github.com/msysgit/msysgit/wiki/Git-cannot-create-a-file-or-directory-with-a-long-path) for details).

.github/CONTRIBUTING.md

@@ -103,7 +103,7 @@ Great question! The short version goes like this:
     
 1. **Switch to the correct branch**
 
-    Switch to the `v10/contrib` branch
+    Switch to the `contrib` branch
 
 1. **Build**
 
@@ -111,7 +111,7 @@ Great question! The short version goes like this:
 
 1. **Branch**
 
-    Create a new branch now and name it after the issue you're fixing, we usually follow the format: `temp-12345`. This means it's a temporary branch for the particular issue you're working on, in this case issue number `12345`.  Don't commit to `v10/contrib`, create a new branch first.
+    Create a new branch now and name it after the issue you're fixing, we usually follow the format: `temp-12345`. This means it's a temporary branch for the particular issue you're working on, in this case issue number `12345`.  Don't commit to `contrib`, create a new branch first.
 
 1. **Change**
 
@@ -121,7 +121,7 @@ Great question! The short version goes like this:
 
     Done? Yay! 🎉
 
-    Remember to commit to your new `temp` branch, and don't commit to `v10/contrib`. Then you can push the changes up to your fork on GitHub.
+    Remember to commit to your new `temp` branch, and don't commit to `contrib`. Then you can push the changes up to your fork on GitHub.
 
 #### Keeping your Umbraco fork in sync with the main repository
 [sync fork]: #keeping-your-umbraco-fork-in-sync-with-the-main-repository
@@ -138,10 +138,10 @@ Then when you want to get the changes from the main repository:
 
 ```
 git fetch upstream
-git rebase upstream/v10/contrib
+git rebase upstream/contrib
 ```
 
-In this command we're syncing with the `v10/contrib` branch, but you can of course choose another one if needed.
+In this command we're syncing with the `contrib` branch, but you can of course choose another one if needed.
 
 [More information on how this works can be found on the thoughtbot blog.][sync fork ext]
 
@@ -169,7 +169,7 @@ We recommend you to [sync with our repository][sync fork] before you submit your
 GitHub will have picked up on the new branch you've pushed and will offer to create a Pull Request. Click that green button and away you go.
 ![Create a pull request](img/createpullrequest.png)
 
-We like to use [git flow][git flow] as much as possible, but don't worry if you are not familiar with it. The most important thing you need to know is that when you fork the Umbraco repository, the default branch is set to something, usually `v10/contrib`. If you are working on v9, this is the branch you should be targeting.
+We like to use [git flow][git flow] as much as possible, but don't worry if you are not familiar with it. The most important thing you need to know is that when you fork the Umbraco repository, the default branch is set to `contrib`. This is the branch you should be targeting.
 
 Please note: we are no longer accepting features for v8 and below but will continue to merge security fixes as and when they arise.
 

.github/README.md

@@ -1,4 +1,4 @@
-# [Umbraco CMS](https://umbraco.com) · [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](../LICENSE.md) [![Build status](https://umbraco.visualstudio.com/Umbraco%20Cms/_apis/build/status/Cms%208%20Continuous?branchName=v8/contrib)](https://umbraco.visualstudio.com/Umbraco%20Cms/_build?definitionId=75) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md) [![Twitter](https://img.shields.io/twitter/follow/umbraco.svg?style=social&label=Follow)](https://twitter.com/intent/follow?screen_name=umbraco) [![Discord](https://img.shields.io/discord/869656431308189746)](https://discord.gg/umbraco)
+# [Umbraco CMS](https://umbraco.com) · [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](../LICENSE.md) [![Build status](https://umbraco.visualstudio.com/Umbraco%20Cms/_apis/build/status/Cms%208%20Continuous?branchName=v8/contrib)](https://umbraco.visualstudio.com/Umbraco%20Cms/_build?definitionId=75) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md) [![Twitter](https://img.shields.io/twitter/follow/umbraco.svg?style=social&label=Follow)](https://twitter.com/intent/follow?screen_name=umbraco) [![Discord](https://img.shields.io/discord/869656431308189746)](https://discord.gg/umbraco) [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?hide_repo_select=true&ref=v11%2Fcontrib&repo=10601208&machine=basicLinux32gb&devcontainer_path=.devcontainer%2Fdevcontainer.json&location=WestEurope)
 
 Umbraco is the friendliest, most flexible and fastest growing ASP.NET CMS, and used by more than 500,000 websites worldwide. Our mission is to help you deliver delightful digital experiences by making Umbraco friendly, simpler and social.
 
@@ -31,7 +31,8 @@ The documentation for Umbraco CMS can be found [on Our Umbraco](https://docs.umb
 
 Our friendly community is available 24/7 at the community hub, we call ["Our Umbraco"](https://our.umbraco.com/). Our Umbraco features forums for questions and answers, documentation, downloadable plugins for Umbraco, and a rich collection of community resources.
 
-Besides "Our", we all support each other also via Twitter: [Umbraco HQ](https://twitter.com/umbraco), [Release Updates](https://twitter.com/umbracoproject), [#umbraco](https://twitter.com/hashtag/umbraco)
+Besides "Our", we all support each other in our [Community Discord Server](https://discord.gg/umbraco) and on Twitter: [Umbraco HQ](https://twitter.com/umbraco), [Release Updates](https://twitter.com/umbracoproject), [#umbraco](https://twitter.com/hashtag/umbraco)
+
 
 
 ## Contributing

.github/codespaces-readme.md

@@ -0,0 +1,21 @@
+# GitHub CodeSpaces
+Umbraco source code can be edited inside the browser with VSCode and CodeSpaces.
+
+This development environment comes with all the tools you need to build Umbraco source code.
+
+
+## Debugging and Running
+From VSCode browse to the Run and Debug section and then click the green button. This will build the Umbraco source code and attach a debugger and launch the site.
+
+## Default Umbraco credentials
+Username: test@umbraco.com
+Password: password1234
+
+## Test Email Server
+ A SMTP4Dev instance for testing email is available on port 5000.
+
+## SQLite Database
+The SQLite extension is preinstalled and allows you to open, query, edit the data inside the Umbraco SQLite database for ease of use.
+
+
+

.github/workflows/codeql-analysis.yml

@@ -15,8 +15,8 @@ permissions:
   contents: read
 
 env:
-  dotnetVersion: 6.x
-  dotnetIncludePreviewVersions: false
+  dotnetVersion: 7.x
+  dotnetIncludePreviewVersions: true
   solution: umbraco.sln
   buildConfiguration: SkipTests
   DOTNET_NOLOGO: true

.gitignore

@@ -101,6 +101,12 @@ preserve.belle
 /tests/Umbraco.Tests.UnitTests/[Uu]mbraco/[Dd]ata/TEMP/
 
 # Ignore auto-generated schema
-/src/Umbraco.Cms/appsettings-schema.json
+/src/Umbraco.Cms.Targets/tasks/
+/src/Umbraco.Cms.Targets/appsettings-schema.*.json
 /src/Umbraco.Web.UI/appsettings-schema.json
+/src/Umbraco.Web.UI/appsettings-schema.*.json
 /tests/Umbraco.Tests.Integration/appsettings-schema.json
+/tests/Umbraco.Tests.Integration/appsettings-schema.*.json
+/src/Umbraco.Cms/appsettings-schema.json
+playwright-report
+trace.zip

.vscode/launch.json

@@ -8,7 +8,6 @@
             "name": ".NET Core Launch (web)",
             "type": "coreclr",
             "request": "launch",
-            "preLaunchTask": "Dotnet build",
             "program": "dotnet",
             "args": ["run"],
             "cwd": "${workspaceFolder}/src/Umbraco.Web.UI",

Directory.Build.props

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project>
   <PropertyGroup>
-    <TargetFramework>net6.0</TargetFramework>
+    <TargetFramework>net7.0</TargetFramework>
+    <LangVersion>latest</LangVersion>
     <Company>Umbraco HQ</Company>
     <Authors>Umbraco</Authors>
     <Copyright>Copyright © Umbraco $([System.DateTime]::Today.ToString('yyyy'))</Copyright>
@@ -28,8 +29,9 @@
 
   <!-- Package Validation -->
   <PropertyGroup>
+    <GenerateCompatibilitySuppressionFile>false</GenerateCompatibilitySuppressionFile>
     <EnablePackageValidation>true</EnablePackageValidation>
-    <PackageValidationBaselineVersion>10.0.0</PackageValidationBaselineVersion>
+    <PackageValidationBaselineVersion>11.0.0-rc1</PackageValidationBaselineVersion>
     <EnableStrictModeForCompatibleFrameworksInPackage>true</EnableStrictModeForCompatibleFrameworksInPackage>
     <EnableStrictModeForCompatibleTfms>true</EnableStrictModeForCompatibleTfms>
   </PropertyGroup>
@@ -39,7 +41,7 @@
     <PackageReference Include="Nerdbank.GitVersioning" Version="3.5.113" PrivateAssets="all" IsImplicitlyDefined="true" />
     <PackageReference Include="StyleCop.Analyzers" Version="1.2.0-beta.406" PrivateAssets="all" IsImplicitlyDefined="true" />
     <PackageReference Include="Umbraco.Code" Version="2.0.0" PrivateAssets="all" IsImplicitlyDefined="true" />
-    <PackageReference Include="Umbraco.GitVersioning.Extensions" Version="0.1.1" PrivateAssets="all" IsImplicitlyDefined="true" />
+    <PackageReference Include="Umbraco.GitVersioning.Extensions" Version="0.2.0" PrivateAssets="all" IsImplicitlyDefined="true" />
   </ItemGroup>
 
   <ItemGroup>

build/azure-pipelines.yml

@@ -23,9 +23,9 @@ parameters:
     default: false
 
 variables:
-  nodeVersion: 14.18.1
-  dotnetVersion: 6.x
-  dotnetIncludePreviewVersions: false
+  nodeVersion: 16.17.0
+  dotnetVersion: 7.x
+  dotnetIncludePreviewVersions: true
   solution: umbraco.sln
   buildConfiguration: Release
   UMBRACO__CMS__GLOBAL__ID: 00000000-0000-0000-0000-000000000042
@@ -72,7 +72,6 @@ stages:
             displayName: Use .NET $(dotnetVersion)
             inputs:
               version: $(dotnetVersion)
-              performMultiLevelLookup: true
               includePreviewVersions: $(dotnetIncludePreviewVersions)
           - task: DotNetCoreCLI@2
             displayName: Run dotnet restore
@@ -111,7 +110,7 @@ stages:
                   }
                 }
 
-                dotnet pack $(solution) --configuration $(buildConfiguration) -p:BuildProjectReferences=false --output $(Build.ArtifactStagingDirectory)/nupkg
+                dotnet pack $(solution) --configuration $(buildConfiguration) --no-build --property:PackageOutputPath=$(Build.ArtifactStagingDirectory)/nupkg
           - script: |
               sha="$(Build.SourceVersion)"
               sha=${sha:0:7}
@@ -246,7 +245,6 @@ stages:
             displayName: Use .NET $(dotnetVersion)
             inputs:
               version: $(dotnetVersion)
-              performMultiLevelLookup: true
               includePreviewVersions: $(dotnetIncludePreviewVersions)
           - task: DotNetCoreCLI@2
             displayName: Run dotnet test
@@ -283,7 +281,6 @@ stages:
             displayName: Use .NET $(dotnetVersion)
             inputs:
               version: $(dotnetVersion)
-              performMultiLevelLookup: true
               includePreviewVersions: $(dotnetIncludePreviewVersions)
           - task: DotNetCoreCLI@2
             displayName: Run dotnet test
@@ -321,6 +318,11 @@ stages:
             inputs:
               artifact: build_output
               path: $(Build.SourcesDirectory)
+          - task: UseDotNet@2
+            displayName: Use .NET $(dotnetVersion)
+            inputs:
+              version: $(dotnetVersion)
+              includePreviewVersions: $(dotnetIncludePreviewVersions)
           - powershell: sqllocaldb start mssqllocaldb
             displayName: Start localdb (Windows only)
             condition: and(succeeded(), eq(variables['Agent.OS'], 'Windows_NT'))
@@ -361,6 +363,7 @@ stages:
               dockerImageName: umbraco-linux
             Windows:
               vmImage: 'windows-latest'
+              DOTNET_GENERATE_ASPNET_CERTIFICATE: true # Automatically generate HTTPS development certificate on Windows
               # Enable console logging in Release mode
               Serilog__WriteTo__0__Name: Async
               Serilog__WriteTo__0__Args__configure__0__Name: Console
@@ -414,7 +417,6 @@ stages:
             displayName: Use .NET $(dotnetVersion)
             inputs:
               version: $(dotnetVersion)
-              performMultiLevelLookup: true
               includePreviewVersions: $(dotnetIncludePreviewVersions)
           - pwsh: |
               $sha = 'g$(Build.SourceVersion)'.substring(0, 8)
@@ -450,6 +452,8 @@ stages:
             workingDirectory: tests/Umbraco.Tests.AcceptanceTest
             env:
               CI: true
+              CommitId: $(Build.SourceVersion)
+              AgentOs: $(Agent.OS)
           - pwsh: |
               docker logs $(dockerImageName) > $(Build.ArtifactStagingDirectory)/playwright.log 2>&1
               docker stop $(dockerImageName)
@@ -506,7 +510,6 @@ stages:
               packagesToPush: $(Build.ArtifactStagingDirectory)/**/*.nupkg
               nuGetFeedType: 'external'
               publishFeedCredentials: 'MyGet - Pre-releases'
-
   - stage: Deploy_NuGet
     displayName: NuGet release
     dependsOn:

opened-issue-first-comment.yml

@@ -1,53 +0,0 @@
-name: issue-first-response
-
-on:
-  issues:
-    types: [opened]
-
-jobs: 
-  send-response:
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write
-      pull-requests: write    
-    steps:
-      - name: Install dependencies
-        run: |
-          npm install node-fetch@2
-      - name: Fetch random comment 🗣️ and add it to the issue
-        uses: actions/github-script@v6
-        with:
-          script: |
-            const fetch = require('node-fetch')
-
-            const response = await fetch('https://collaboratorsv2.euwest01.umbraco.io/umbraco/api/comments/PostComment', {
-              method: 'post',
-              body: JSON.stringify({
-                repo: '${{ github.repository }}',
-                number: '${{ github.event.number }}',
-                actor: '${{ github.actor }}',
-                commentType: 'opened-issue-first-comment'
-              }),
-              headers: {
-                'Authorization': 'Bearer ${{ secrets.OUR_BOT_API_TOKEN }}',
-                'Content-Type': 'application/json'
-              }
-            });
-
-            try {
-                const data = await response.text();
-
-                if(response.status === 200 && data !== '') {
-                    github.rest.issues.createComment({
-                        issue_number: context.issue.number,
-                        owner: context.repo.owner,
-                        repo: context.repo.repo,
-                        body: data
-                    });
-                } else {
-                    console.log("Status code did not indicate success:", response.status);
-                    console.log("Returned data:", data);
-                }
-            } catch(error) {
-                console.log(error);
-            }

src/JsonSchema/AppSettings.cs

@@ -1,137 +0,0 @@
-// Copyright (c) Umbraco.
-// See LICENSE for more details.
-
-using Umbraco.Cms.Core.Configuration;
-using Umbraco.Cms.Core.Configuration.Models;
-using Umbraco.Deploy.Core.Configuration.DebugConfiguration;
-using Umbraco.Deploy.Core.Configuration.DeployConfiguration;
-using Umbraco.Deploy.Core.Configuration.DeployProjectConfiguration;
-using Umbraco.Forms.Core.Configuration;
-using SecuritySettings = Umbraco.Cms.Core.Configuration.Models.SecuritySettings;
-
-namespace JsonSchema
-{
-    internal class AppSettings
-    {
-        /// <summary>
-        ///     Gets or sets the Umbraco
-        /// </summary>
-        public UmbracoDefinition? Umbraco { get; set; }
-
-        /// <summary>
-        ///     Configuration of Umbraco CMS and packages
-        /// </summary>
-        internal class UmbracoDefinition
-        {
-            // ReSharper disable once InconsistentNaming
-            public CmsDefinition? CMS { get; set; }
-
-            public FormsDefinition? Forms { get; set; }
-
-            public DeployDefinition? Deploy { get; set; }
-
-            /// <summary>
-            ///     Configurations for the Umbraco CMS
-            /// </summary>
-            public class CmsDefinition
-            {
-                public ContentSettings? Content { get; set; }
-                public CoreDebugSettings? Debug { get; set; }
-
-                public ExceptionFilterSettings? ExceptionFilter { get; set; }
-
-                public ModelsBuilderSettings? ModelsBuilder { get; set; }
-
-                public GlobalSettings? Global { get; set; }
-
-                public HealthChecksSettings? HealthChecks { get; set; }
-
-                public HostingSettings? Hosting { get; set; }
-
-                public ImagingSettings? Imaging { get; set; }
-
-                public IndexCreatorSettings? Examine { get; set; }
-
-                public KeepAliveSettings? KeepAlive { get; set; }
-
-                public LoggingSettings? Logging { get; set; }
-
-                public NuCacheSettings? NuCache { get; set; }
-
-                public RequestHandlerSettings? RequestHandler { get; set; }
-
-                public RuntimeSettings? Runtime { get; set; }
-
-                public SecuritySettings? Security { get; set; }
-
-                public TourSettings? Tours { get; set; }
-
-                public TypeFinderSettings? TypeFinder { get; set; }
-
-                public WebRoutingSettings? WebRouting { get; set; }
-
-                public UmbracoPluginSettings? Plugins { get; set; }
-
-                public UnattendedSettings? Unattended { get; set; }
-
-                public RichTextEditorSettings? RichTextEditor { get; set; }
-
-                public RuntimeMinificationSettings? RuntimeMinification { get; set; }
-
-                public BasicAuthSettings? BasicAuth { get; set; }
-
-                public PackageMigrationSettings? PackageMigration { get; set; }
-
-                public LegacyPasswordMigrationSettings? LegacyPasswordMigration { get; set; }
-
-                public ContentDashboardSettings? ContentDashboard { get; set; }
-
-                public HelpPageSettings? HelpPage { get; set; }
-
-                public InstallDefaultDataSettings? DefaultDataCreation { get; set; }
-
-                public DataTypesSettings? DataTypes { get; set; }
-
-                public MarketplaceSettings? Marketplace { get; set; }
-            }
-
-            /// <summary>
-            ///     Configurations for the Umbraco Forms package to Umbraco CMS
-            /// </summary>
-            public class FormsDefinition
-            {
-                public FormDesignSettings? FormDesign { get; set; }
-
-                public PackageOptionSettings? Options { get; set; }
-
-                public Umbraco.Forms.Core.Configuration.SecuritySettings? Security { get; set; }
-
-                public FieldTypesDefinition? FieldTypes { get; set; }
-
-                /// <summary>
-                ///     Configurations for the Umbraco Forms Field Types
-                /// </summary>
-                public class FieldTypesDefinition
-                {
-                    public DatePickerSettings? DatePicker { get; set; }
-
-                    public Recaptcha2Settings? Recaptcha2 { get; set; }
-
-                    public Recaptcha3Settings? Recaptcha3 { get; set; }
-                }
-            }
-
-            /// <summary>
-            ///     Configurations for the Umbraco Deploy package to Umbraco CMS
-            /// </summary>
-            public class DeployDefinition
-            {
-                public DeploySettings? Settings { get; set; }
-
-                public DeployProjectConfig? Project { get; set; }
-
-                public DebugSettings? Debug { get; set; }
-            }
-        }
-    }
-}

src/JsonSchema/NamespacePrefixedSchemaNameGenerator.cs

@@ -1,13 +0,0 @@
-// Copyright (c) Umbraco.
-// See LICENSE for more details.
-
-using System;
-using NJsonSchema.Generation;
-
-namespace JsonSchema
-{
-    internal class NamespacePrefixedSchemaNameGenerator : DefaultSchemaNameGenerator
-    {
-        public override string Generate(Type type) => type.Namespace?.Replace(".", string.Empty) + base.Generate(type);
-    }
-}

src/JsonSchema/Options.cs

@@ -1,13 +0,0 @@
-// Copyright (c) Umbraco.
-// See LICENSE for more details.
-
-using CommandLine;
-
-namespace JsonSchema
-{
-    internal class Options
-    {
-        [Option('o', "outputFile", Required = false, HelpText = "Set path of the output file.", Default = "appsettings-schema.json")]
-        public string OutputFile { get; set; } = null!;
-    }
-}

src/JsonSchema/Program.cs

@@ -1,41 +0,0 @@
-// Copyright (c) Umbraco.
-// See LICENSE for more details.
-
-using System;
-using System.IO;
-using System.Threading.Tasks;
-using CommandLine;
-
-namespace JsonSchema
-{
-    internal class Program
-    {
-        public static async Task Main(string[] args)
-        {
-            try
-            {
-                await Parser.Default.ParseArguments<Options>(args)
-                    .WithParsedAsync(Execute);
-            }
-            catch (Exception e)
-            {
-                Console.WriteLine(e);
-                throw;
-            }
-        }
-
-        private static async Task Execute(Options options)
-        {
-            var generator = new UmbracoJsonSchemaGenerator();
-            var schema = await generator.Generate();
-
-            var path = Path.GetFullPath(Path.Combine(Environment.CurrentDirectory, options.OutputFile));
-            Console.WriteLine("Path to use {0}", path);
-            Directory.CreateDirectory(Path.GetDirectoryName(path)!);
-            Console.WriteLine("Ensured directory exists");
-            await File.WriteAllTextAsync(path, schema);
-
-            Console.WriteLine("File written at {0}", path);
-        }
-    }
-}

src/JsonSchema/UmbracoJsonSchemaGenerator.cs

@@ -1,58 +0,0 @@
-// Copyright (c) Umbraco.
-// See LICENSE for more details.
-
-using Newtonsoft.Json;
-using Newtonsoft.Json.Linq;
-using NJsonSchema.Generation;
-using Umbraco.Cms.Core.Configuration.Models;
-
-namespace JsonSchema
-{
-    /// <summary>
-    ///     Generator of the JsonSchema for AppSettings.json including A specific Umbraco version.
-    /// </summary>
-    public class UmbracoJsonSchemaGenerator
-    {
-        private static readonly HttpClient s_client = new ();
-        private readonly JsonSchemaGenerator _innerGenerator;
-
-        /// <summary>
-        ///     Initializes a new instance of the <see cref="UmbracoJsonSchemaGenerator" /> class.
-        /// </summary>
-        public UmbracoJsonSchemaGenerator()
-            => _innerGenerator = new JsonSchemaGenerator(new UmbracoJsonSchemaGeneratorSettings());
-
-        /// <summary>
-        ///     Generates a json representing the JsonSchema for AppSettings.json including A specific Umbraco version..
-        /// </summary>
-        public async Task<string> Generate()
-        {
-            JObject umbracoSchema = GenerateUmbracoSchema();
-            JObject officialSchema = await GetOfficialAppSettingsSchema();
-
-            officialSchema.Merge(umbracoSchema);
-
-            return officialSchema.ToString();
-        }
-
-        private async Task<JObject> GetOfficialAppSettingsSchema()
-        {
-            HttpResponseMessage response = await s_client.GetAsync("https://json.schemastore.org/appsettings.json")
-                .ConfigureAwait(false);
-
-            var result = await response.Content.ReadAsStringAsync();
-
-            return JsonConvert.DeserializeObject<JObject>(result)!;
-        }
-
-        private JObject GenerateUmbracoSchema()
-        {
-            NJsonSchema.JsonSchema schema = _innerGenerator.Generate(typeof(AppSettings));
-
-            // TODO: when the "UmbracoPath" setter is removed from "GlobalSettings" (scheduled for V12), remove this line as well
-            schema.Definitions["UmbracoCmsCoreConfigurationModelsGlobalSettings"]?.Properties?.Remove(nameof(GlobalSettings.UmbracoPath));
-
-            return JsonConvert.DeserializeObject<JObject>(schema.ToJson())!;
-        }
-    }
-}

src/JsonSchema/UmbracoJsonSchemaGeneratorSettings.cs

@@ -1,43 +0,0 @@
-// Copyright (c) Umbraco.
-// See LICENSE for more details.
-
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using Newtonsoft.Json;
-using Newtonsoft.Json.Converters;
-using Newtonsoft.Json.Serialization;
-using NJsonSchema.Generation;
-
-namespace JsonSchema
-{
-    /// <inheritdoc />
-    public class UmbracoJsonSchemaGeneratorSettings : JsonSchemaGeneratorSettings
-    {
-        /// <summary>
-        /// Initializes a new instance of the <see cref="UmbracoJsonSchemaGeneratorSettings"/> class.
-        /// </summary>
-        public UmbracoJsonSchemaGeneratorSettings()
-        {
-            AlwaysAllowAdditionalObjectProperties = true;
-            SerializerSettings = new JsonSerializerSettings()
-            {
-                ContractResolver = new WritablePropertiesOnlyResolver()
-            };
-            DefaultReferenceTypeNullHandling = ReferenceTypeNullHandling.NotNull;
-            SchemaNameGenerator = new NamespacePrefixedSchemaNameGenerator();
-            SerializerSettings.Converters.Add(new StringEnumConverter());
-            IgnoreObsoleteProperties = true;
-            GenerateExamples = true;
-        }
-
-        private class WritablePropertiesOnlyResolver : DefaultContractResolver
-        {
-            protected override IList<JsonProperty> CreateProperties(Type type, MemberSerialization memberSerialization)
-            {
-                IList<JsonProperty> props = base.CreateProperties(type, memberSerialization);
-                return props.Where(p => p.Writable).ToList();
-            }
-        }
-    }
-}

src/Umbraco.Cms.Imaging.ImageSharp/ConfigureImageSharpMiddlewareOptions.cs

@@ -8,7 +8,7 @@ using SixLabors.ImageSharp.Web.Middleware;
 using SixLabors.ImageSharp.Web.Processors;
 using Umbraco.Cms.Core.Configuration.Models;
 
-namespace Umbraco.Cms.Web.Common.DependencyInjection;
+namespace Umbraco.Cms.Imaging.ImageSharp;
 
 /// <summary>
 ///     Configures the ImageSharp middleware options.

src/Umbraco.Cms.Imaging.ImageSharp/ConfigurePhysicalFileSystemCacheOptions.cs

@@ -4,7 +4,7 @@ using SixLabors.ImageSharp.Web.Caching;
 using Umbraco.Cms.Core.Configuration.Models;
 using Umbraco.Cms.Core.Extensions;
 
-namespace Umbraco.Cms.Web.Common.DependencyInjection;
+namespace Umbraco.Cms.Imaging.ImageSharp;
 
 /// <summary>
 ///     Configures the ImageSharp physical file system cache options.

src/Umbraco.Cms.Imaging.ImageSharp/ImageProcessors/CropWebProcessor.cs

@@ -8,20 +8,21 @@ using SixLabors.ImageSharp.Web;
 using SixLabors.ImageSharp.Web.Commands;
 using SixLabors.ImageSharp.Web.Processors;
 
-namespace Umbraco.Cms.Web.Common.ImageProcessors;
+namespace Umbraco.Cms.Imaging.ImageSharp.ImageProcessors;
 
 /// <summary>
-///     Allows the cropping of images.
+/// Allows the cropping of images.
 /// </summary>
+/// <seealso cref="SixLabors.ImageSharp.Web.Processors.IImageWebProcessor" />
 public class CropWebProcessor : IImageWebProcessor
 {
     /// <summary>
-    ///     The command constant for the crop coordinates.
+    /// The command constant for the crop coordinates.
     /// </summary>
     public const string Coordinates = "cc";
 
     /// <summary>
-    ///     The command constant for the resize orientation handling mode.
+    /// The command constant for the resize orientation handling mode.
     /// </summary>
     public const string Orient = "orient";
 
@@ -59,10 +60,8 @@ public class CropWebProcessor : IImageWebProcessor
         var right = Math.Clamp(1 - coordinates[2], 0, 1);
         var bottom = Math.Clamp(1 - coordinates[3], 0, 1);
         var orientation = GetExifOrientation(image, commands, parser, culture);
-        Vector2 xy1 =
-            ExifOrientationUtilities.Transform(new Vector2(left, top), Vector2.Zero, Vector2.One, orientation);
-        Vector2 xy2 =
-            ExifOrientationUtilities.Transform(new Vector2(right, bottom), Vector2.Zero, Vector2.One, orientation);
+        Vector2 xy1 = ExifOrientationUtilities.Transform(new Vector2(left, top), Vector2.Zero, Vector2.One, orientation);
+        Vector2 xy2 = ExifOrientationUtilities.Transform(new Vector2(right, bottom), Vector2.Zero, Vector2.One, orientation);
 
         // Scale points to a pixel based rectangle
         Size size = image.Image.Size();

src/Umbraco.Cms.Imaging.ImageSharp/ImageSharpComposer.cs

@@ -0,0 +1,16 @@
+using Umbraco.Cms.Core.Composing;
+using Umbraco.Cms.Core.DependencyInjection;
+using Umbraco.Extensions;
+
+namespace Umbraco.Cms.Imaging.ImageSharp;
+
+/// <summary>
+/// Adds imaging support using ImageSharp/ImageSharp.Web.
+/// </summary>
+/// <seealso cref="Umbraco.Cms.Core.Composing.IComposer" />
+public sealed class ImageSharpComposer : IComposer
+{
+    /// <inheritdoc />
+    public void Compose(IUmbracoBuilder builder)
+        => builder.AddUmbracoImageSharp();
+}

src/Umbraco.Cms.Imaging.ImageSharp/Media/ImageSharpDimensionExtractor.cs

@@ -3,26 +3,27 @@ using SixLabors.ImageSharp.Metadata.Profiles.Exif;
 using Umbraco.Cms.Core.Media;
 using Size = System.Drawing.Size;
 
-namespace Umbraco.Cms.Infrastructure.Media;
+namespace Umbraco.Cms.Imaging.ImageSharp.Media;
 
-internal class ImageSharpDimensionExtractor : IImageDimensionExtractor
+public sealed class ImageSharpDimensionExtractor : IImageDimensionExtractor
 {
     private readonly Configuration _configuration;
 
+    /// <inheritdoc />
+    public IEnumerable<string> SupportedImageFileTypes { get; }
+
     /// <summary>
-    ///     Initializes a new instance of the <see cref="ImageSharpDimensionExtractor" /> class.
+    /// Initializes a new instance of the <see cref="ImageSharpDimensionExtractor" /> class.
     /// </summary>
     /// <param name="configuration">The configuration.</param>
     public ImageSharpDimensionExtractor(Configuration configuration)
-        => _configuration = configuration;
+    {
+        _configuration = configuration ?? throw new ArgumentNullException(nameof(configuration));
 
-    /// <summary>
-    ///     Gets the dimensions of an image.
-    /// </summary>
-    /// <param name="stream">A stream containing the image bytes.</param>
-    /// <returns>
-    ///     The dimension of the image.
-    /// </returns>
+        SupportedImageFileTypes = configuration.ImageFormats.SelectMany(f => f.FileExtensions).ToArray();
+    }
+
+    /// <inheritdoc />
     public Size? GetDimensions(Stream? stream)
     {
         Size? size = null;

src/Umbraco.Cms.Imaging.ImageSharp/Media/ImageSharpImageUrlGenerator.cs

@@ -5,25 +5,27 @@ using SixLabors.ImageSharp;
 using SixLabors.ImageSharp.Web.Processors;
 using Umbraco.Cms.Core.Media;
 using Umbraco.Cms.Core.Models;
-using Umbraco.Cms.Web.Common.ImageProcessors;
+using Umbraco.Cms.Imaging.ImageSharp.ImageProcessors;
 using static Umbraco.Cms.Core.Models.ImageUrlGenerationOptions;
 
-namespace Umbraco.Cms.Web.Common.Media;
+namespace Umbraco.Cms.Imaging.ImageSharp.Media;
 
 /// <summary>
 ///     Exposes a method that generates an image URL based on the specified options that can be processed by ImageSharp.
 /// </summary>
 /// <seealso cref="IImageUrlGenerator" />
-public class ImageSharpImageUrlGenerator : IImageUrlGenerator
+public sealed class ImageSharpImageUrlGenerator : IImageUrlGenerator
 {
+    /// <inheritdoc />
+    public IEnumerable<string> SupportedImageFileTypes { get; }
+
     /// <summary>
     ///     Initializes a new instance of the <see cref="ImageSharpImageUrlGenerator" /> class.
     /// </summary>
     /// <param name="configuration">The ImageSharp configuration.</param>
     public ImageSharpImageUrlGenerator(Configuration configuration)
         : this(configuration.ImageFormats.SelectMany(f => f.FileExtensions).ToArray())
-    {
-    }
+    { }
 
     /// <summary>
     ///     Initializes a new instance of the <see cref="ImageSharpImageUrlGenerator" /> class.
@@ -35,9 +37,6 @@ public class ImageSharpImageUrlGenerator : IImageUrlGenerator
     internal ImageSharpImageUrlGenerator(IEnumerable<string> supportedImageFileTypes) =>
         SupportedImageFileTypes = supportedImageFileTypes;
 
-    /// <inheritdoc />
-    public IEnumerable<string> SupportedImageFileTypes { get; }
-
     /// <inheritdoc />
     public string? GetImageUrl(ImageUrlGenerationOptions? options)
     {

src/Umbraco.Cms.Imaging.ImageSharp/Umbraco.Cms.Imaging.ImageSharp.csproj

@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <Title>Umbraco CMS - Imaging - ImageSharp</Title>
+    <Description>Adds imaging support using ImageSharp/ImageSharp.Web to Umbraco CMS.</Description>
+    <!-- TODO: Enable when final version is shipped (because there's currently no previous version) -->
+    <EnablePackageValidation>false</EnablePackageValidation>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="SixLabors.ImageSharp" Version="2.1.3" />
+    <PackageReference Include="SixLabors.ImageSharp.Web" Version="2.0.2" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Umbraco.Web.Common\Umbraco.Web.Common.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <AssemblyAttribute Include="System.Runtime.CompilerServices.InternalsVisibleTo">
+      <_Parameter1>Umbraco.Tests.UnitTests</_Parameter1>
+    </AssemblyAttribute>
+  </ItemGroup>
+</Project>

src/Umbraco.Cms.Imaging.ImageSharp/UmbracoBuilderExtensions.cs

@@ -0,0 +1,54 @@
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Options;
+using SixLabors.ImageSharp;
+using SixLabors.ImageSharp.Web.Caching;
+using SixLabors.ImageSharp.Web.DependencyInjection;
+using SixLabors.ImageSharp.Web.Middleware;
+using SixLabors.ImageSharp.Web.Providers;
+using Umbraco.Cms.Core.DependencyInjection;
+using Umbraco.Cms.Core.Media;
+using Umbraco.Cms.Imaging.ImageSharp.ImageProcessors;
+using Umbraco.Cms.Imaging.ImageSharp.Media;
+using Umbraco.Cms.Web.Common.ApplicationBuilder;
+using Umbraco.Extensions;
+
+namespace Umbraco.Cms.Imaging.ImageSharp;
+
+public static class UmbracoBuilderExtensions
+{
+    /// <summary>
+    ///     Adds Image Sharp with Umbraco settings
+    /// </summary>
+    public static IServiceCollection AddUmbracoImageSharp(this IUmbracoBuilder builder)
+    {
+        // Add default ImageSharp configuration and service implementations
+        builder.Services.AddSingleton(Configuration.Default);
+        builder.Services.AddUnique<IImageDimensionExtractor, ImageSharpDimensionExtractor>();
+
+        builder.Services.AddSingleton<IImageUrlGenerator, ImageSharpImageUrlGenerator>();
+
+        builder.Services.AddImageSharp()
+            // Replace default image provider
+            .ClearProviders()
+            .AddProvider<WebRootImageProvider>()
+            // Add custom processors
+            .AddProcessor<CropWebProcessor>();
+
+        // Configure middleware
+        builder.Services.AddTransient<IConfigureOptions<ImageSharpMiddlewareOptions>, ConfigureImageSharpMiddlewareOptions>();
+
+        // Configure cache options
+        builder.Services.AddTransient<IConfigureOptions<PhysicalFileSystemCacheOptions>, ConfigurePhysicalFileSystemCacheOptions>();
+
+        // Important we handle image manipulations before the static files, otherwise the querystring is just ignored
+        builder.Services.Configure<UmbracoPipelineOptions>(options =>
+        {
+            options.AddFilter(new UmbracoPipelineFilter(nameof(ImageSharpComposer))
+            {
+                PrePipeline = prePipeline => prePipeline.UseImageSharp()
+            });
+        });
+
+        return builder.Services;
+    }
+}

src/Umbraco.Cms.ManagementApi/Controllers/Analytics/AllAnalyticsController.cs

@@ -1,22 +0,0 @@
-using Microsoft.AspNetCore.Http;
-using Microsoft.AspNetCore.Mvc;
-using Umbraco.Cms.Core.Models;
-using Umbraco.Cms.ManagementApi.ViewModels.Pagination;
-
-namespace Umbraco.Cms.ManagementApi.Controllers.Analytics;
-
-public class AllAnalyticsController : AnalyticsControllerBase
-{
-    [HttpGet("all")]
-    [MapToApiVersion("1.0")]
-    [ProducesResponseType(typeof(PagedViewModel<TelemetryLevel>), StatusCodes.Status200OK)]
-    public async Task<PagedViewModel<TelemetryLevel>> GetAll(int skip, int take)
-    {
-        TelemetryLevel[] levels = Enum.GetValues<TelemetryLevel>();
-        return await Task.FromResult(new PagedViewModel<TelemetryLevel>
-        {
-            Total = levels.Length,
-            Items = levels.Skip(skip).Take(take),
-        });
-    }
-}

src/Umbraco.Cms.ManagementApi/Controllers/Analytics/AnalyticsControllerBase.cs

@@ -1,13 +0,0 @@
-using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
-using Umbraco.New.Cms.Web.Common.Routing;
-
-namespace Umbraco.Cms.ManagementApi.Controllers.Analytics;
-
-[ApiController]
-[BackOfficeRoute("api/v{version:apiVersion}/analytics")]
-[OpenApiTag("Analytics")]
-[ApiVersion("1.0")]
-public abstract class AnalyticsControllerBase : ManagementApiControllerBase
-{
-}

src/Umbraco.Cms.ManagementApi/Controllers/Analytics/GetAnalyticsController.cs

@@ -1,18 +0,0 @@
-using Microsoft.AspNetCore.Http;
-using Microsoft.AspNetCore.Mvc;
-using Umbraco.Cms.Core.Services;
-using Umbraco.Cms.ManagementApi.ViewModels.Analytics;
-
-namespace Umbraco.Cms.ManagementApi.Controllers.Analytics;
-
-public class GetAnalyticsController : AnalyticsControllerBase
-{
-    private readonly IMetricsConsentService _metricsConsentService;
-
-    public GetAnalyticsController(IMetricsConsentService metricsConsentService) => _metricsConsentService = metricsConsentService;
-
-    [HttpGet]
-    [MapToApiVersion("1.0")]
-    [ProducesResponseType(typeof(AnalyticsLevelViewModel), StatusCodes.Status200OK)]
-    public async Task<AnalyticsLevelViewModel> Get() => await Task.FromResult(new AnalyticsLevelViewModel { AnalyticsLevel = _metricsConsentService.GetConsentLevel() });
-}

src/Umbraco.Cms.ManagementApi/Controllers/Culture/CultureControllerBase.cs

@@ -1,12 +1,11 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.New.Cms.Web.Common.Routing;
 
 namespace Umbraco.Cms.ManagementApi.Controllers.Culture;
 
 [ApiController]
-[BackOfficeRoute("api/v{version:apiVersion}/culture")]
-[OpenApiTag("Culture")]
+[VersionedApiBackOfficeRoute("culture")]
+[ApiExplorerSettings(GroupName = "Culture")]
 [ApiVersion("1.0")]
 public abstract class CultureControllerBase : ManagementApiControllerBase
 {

src/Umbraco.Cms.ManagementApi/Controllers/DataType/Tree/DataTypeTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Models.Entities;
@@ -12,8 +11,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.DataType.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.DataType}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.DataType))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.DataType}")]
+[ApiExplorerSettings(GroupName = "Data Type")]
 public class DataTypeTreeControllerBase : FolderTreeControllerBase<FolderTreeItemViewModel>
 {
     private readonly IDataTypeService _dataTypeService;

src/Umbraco.Cms.ManagementApi/Controllers/DataType/Tree/ItemsDataTypeTreeController.cs

@@ -12,7 +12,7 @@ public class ItemsDataTypeTreeController : DataTypeTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<FolderTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<FolderTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys)

src/Umbraco.Cms.ManagementApi/Controllers/Dictionary/DictionaryControllerBase.cs

@@ -1,12 +1,11 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.New.Cms.Web.Common.Routing;
 
 namespace Umbraco.Cms.ManagementApi.Controllers.Dictionary;
 
 [ApiController]
-[BackOfficeRoute("api/v{version:apiVersion}/dictionary")]
-[OpenApiTag("Dictionary")]
+[VersionedApiBackOfficeRoute("dictionary")]
+[ApiExplorerSettings(GroupName = "Dictionary")]
 [ApiVersion("1.0")]
 // TODO: Add authentication
 public abstract class DictionaryControllerBase : ManagementApiControllerBase

src/Umbraco.Cms.ManagementApi/Controllers/Dictionary/ExportDictionaryController.cs

@@ -23,13 +23,13 @@ public class ExportDictionaryController : DictionaryControllerBase
     [HttpGet("export/{key:guid}")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(FileContentResult), StatusCodes.Status200OK)]
-    [ProducesResponseType(typeof(NotFoundObjectResult), StatusCodes.Status404NotFound)]
+    [ProducesResponseType(typeof(NotFoundResult), StatusCodes.Status404NotFound)]
     public async Task<IActionResult> ExportDictionary(Guid key, bool includeChildren = false)
     {
         IDictionaryItem? dictionaryItem = _localizationService.GetDictionaryItemById(key);
         if (dictionaryItem is null)
         {
-            return await Task.FromResult(NotFound("No dictionary item found with id "));
+            return await Task.FromResult(NotFound());
         }
 
         XElement xml = _entityXmlSerializer.Serialize(dictionaryItem, includeChildren);

src/Umbraco.Cms.ManagementApi/Controllers/Dictionary/ImportDictionaryController.cs

@@ -4,6 +4,7 @@ using Microsoft.AspNetCore.Hosting;
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
 using Umbraco.Cms.Core;
+using Umbraco.Cms.Core.Extensions;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Services;
 using Umbraco.Cms.ManagementApi.Services;
@@ -13,18 +14,15 @@ namespace Umbraco.Cms.ManagementApi.Controllers.Dictionary;
 
 public class ImportDictionaryController : DictionaryControllerBase
 {
-    private readonly IHostingEnvironment _hostingEnvironment;
     private readonly IDictionaryService _dictionaryService;
     private readonly IWebHostEnvironment _webHostEnvironment;
     private readonly ILoadDictionaryItemService _loadDictionaryItemService;
 
     public ImportDictionaryController(
-        IHostingEnvironment hostingEnvironment,
         IDictionaryService dictionaryService,
         IWebHostEnvironment webHostEnvironment,
         ILoadDictionaryItemService loadDictionaryItemService)
     {
-        _hostingEnvironment = hostingEnvironment;
         _dictionaryService = dictionaryService;
         _webHostEnvironment = webHostEnvironment;
         _loadDictionaryItemService = loadDictionaryItemService;
@@ -41,7 +39,7 @@ public class ImportDictionaryController : DictionaryControllerBase
             return NotFound();
         }
 
-        var filePath = Path.Combine(_hostingEnvironment.MapPathContentRoot(Constants.SystemDirectories.Data), file);
+        var filePath = Path.Combine(_webHostEnvironment.MapPathContentRoot(Constants.SystemDirectories.Data), file);
         if (_webHostEnvironment.ContentRootFileProvider.GetFileInfo(filePath) is null)
         {
             return await Task.FromResult(NotFound());

src/Umbraco.Cms.ManagementApi/Controllers/Dictionary/Tree/ChildrenDictionaryTreeController.cs

@@ -6,11 +6,11 @@ using Umbraco.Cms.ManagementApi.Services.Paging;
 using Umbraco.Cms.ManagementApi.ViewModels.Pagination;
 using Umbraco.Cms.ManagementApi.ViewModels.Tree;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.DictionaryItem.Tree;
+namespace Umbraco.Cms.ManagementApi.Controllers.Dictionary.Tree;
 
-public class ChildrenDictionaryItemTreeController : DictionaryItemTreeControllerBase
+public class ChildrenDictionaryTreeController : DictionaryTreeControllerBase
 {
-    public ChildrenDictionaryItemTreeController(IEntityService entityService, ILocalizationService localizationService)
+    public ChildrenDictionaryTreeController(IEntityService entityService, ILocalizationService localizationService)
         : base(entityService, localizationService)
     {
     }

src/Umbraco.Cms.ManagementApi/Controllers/Dictionary/Tree/DictionaryTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Services;
@@ -7,17 +6,17 @@ using Umbraco.Cms.ManagementApi.Controllers.Tree;
 using Umbraco.Cms.ManagementApi.ViewModels.Tree;
 using Umbraco.New.Cms.Web.Common.Routing;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.DictionaryItem.Tree;
+namespace Umbraco.Cms.ManagementApi.Controllers.Dictionary.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.DictionaryItem}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.DictionaryItem))]
-// NOTE: at the moment dictionary items aren't supported by EntityService, so we have little use of the
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/dictionary")]
+[ApiExplorerSettings(GroupName = "Dictionary")]
+// NOTE: at the moment dictionary items (renamed to dictionary tree) aren't supported by EntityService, so we have little use of the
 // tree controller base. We'll keep it though, in the hope that we can mend EntityService.
-public class DictionaryItemTreeControllerBase : EntityTreeControllerBase<EntityTreeItemViewModel>
+public class DictionaryTreeControllerBase : EntityTreeControllerBase<EntityTreeItemViewModel>
 {
-    public DictionaryItemTreeControllerBase(IEntityService entityService, ILocalizationService localizationService)
+    public DictionaryTreeControllerBase(IEntityService entityService, ILocalizationService localizationService)
         : base(entityService) =>
         LocalizationService = localizationService;
 

src/Umbraco.Cms.ManagementApi/Controllers/Dictionary/Tree/ItemsDictionaryTreeController.cs

@@ -4,16 +4,16 @@ using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Services;
 using Umbraco.Cms.ManagementApi.ViewModels.Tree;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.DictionaryItem.Tree;
+namespace Umbraco.Cms.ManagementApi.Controllers.Dictionary.Tree;
 
-public class ItemsDictionaryItemTreeController : DictionaryItemTreeControllerBase
+public class ItemsDictionaryTreeController : DictionaryTreeControllerBase
 {
-    public ItemsDictionaryItemTreeController(IEntityService entityService, ILocalizationService localizationService)
+    public ItemsDictionaryTreeController(IEntityService entityService, ILocalizationService localizationService)
         : base(entityService, localizationService)
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<FolderTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<FolderTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys)

src/Umbraco.Cms.ManagementApi/Controllers/Dictionary/Tree/RootDictionaryTreeController.cs

@@ -6,11 +6,11 @@ using Umbraco.Cms.ManagementApi.Services.Paging;
 using Umbraco.Cms.ManagementApi.ViewModels.Pagination;
 using Umbraco.Cms.ManagementApi.ViewModels.Tree;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.DictionaryItem.Tree;
+namespace Umbraco.Cms.ManagementApi.Controllers.Dictionary.Tree;
 
-public class RootDictionaryItemTreeController : DictionaryItemTreeControllerBase
+public class RootDictionaryTreeController : DictionaryTreeControllerBase
 {
-    public RootDictionaryItemTreeController(IEntityService entityService, ILocalizationService localizationService)
+    public RootDictionaryTreeController(IEntityService entityService, ILocalizationService localizationService)
         : base(entityService, localizationService)
     {
     }

src/Umbraco.Cms.ManagementApi/Controllers/Document/RecycleBin/DocumentRecycleBinControllerBase.cs

@@ -1,6 +1,5 @@
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Models.Entities;
@@ -14,10 +13,10 @@ namespace Umbraco.Cms.ManagementApi.Controllers.Document.RecycleBin;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.Document}/recycle-bin")]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.RecycleBin}/{Constants.UdiEntityType.Document}")]
 [RequireDocumentTreeRootAccess]
 [ProducesResponseType(StatusCodes.Status401Unauthorized)]
-[OpenApiTag(nameof(Constants.UdiEntityType.Document))]
+[ApiExplorerSettings(GroupName = nameof(Constants.UdiEntityType.Document))]
 public class DocumentRecycleBinControllerBase : RecycleBinControllerBase<RecycleBinItemViewModel>
 {
     public DocumentRecycleBinControllerBase(IEntityService entityService)

src/Umbraco.Cms.ManagementApi/Controllers/Document/Tree/DocumentTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Cache;
 using Umbraco.Cms.Core.Models;
@@ -16,8 +15,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.Document.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.Document}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.Document))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.Document}")]
+[ApiExplorerSettings(GroupName = nameof(Constants.UdiEntityType.Document))]
 public abstract class DocumentTreeControllerBase : UserStartNodeTreeControllerBase<DocumentTreeItemViewModel>
 {
     private readonly IPublicAccessService _publicAccessService;

src/Umbraco.Cms.ManagementApi/Controllers/Document/Tree/ItemsDocumentTreeController.cs

@@ -21,7 +21,7 @@ public class ItemsDocumentTreeController : DocumentTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<DocumentTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<DocumentTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys, Guid? dataTypeKey = null, string? culture = null)

src/Umbraco.Cms.ManagementApi/Controllers/DocumentBlueprint/Tree/DocumentBlueprintTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Models.Entities;
@@ -12,8 +11,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.DocumentBlueprint.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.DocumentBlueprint}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.DocumentBlueprint))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.DocumentBlueprint}")]
+[ApiExplorerSettings(GroupName = "Document Blueprint")]
 public class DocumentBlueprintTreeControllerBase : EntityTreeControllerBase<DocumentBlueprintTreeItemViewModel>
 {
     private readonly IContentTypeService _contentTypeService;

src/Umbraco.Cms.ManagementApi/Controllers/DocumentBlueprint/Tree/ItemsDocumentBlueprintTreeController.cs

@@ -13,7 +13,7 @@ public class ItemsDocumentBlueprintTreeController : DocumentBlueprintTreeControl
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<DocumentBlueprintTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<DocumentBlueprintTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys)

src/Umbraco.Cms.ManagementApi/Controllers/DocumentType/Tree/DocumentTypeTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Models.Entities;
@@ -12,8 +11,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.DocumentType.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.DocumentType}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.DocumentType))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.DocumentType}")]
+[ApiExplorerSettings(GroupName = "Document Type")]
 public class DocumentTypeTreeControllerBase : FolderTreeControllerBase<DocumentTypeTreeItemViewModel>
 {
     private readonly IContentTypeService _contentTypeService;

src/Umbraco.Cms.ManagementApi/Controllers/DocumentType/Tree/ItemsDocumentTypeTreeController.cs

@@ -12,7 +12,7 @@ public class ItemsDocumentTypeTreeController : DocumentTypeTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<DocumentTypeTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<DocumentTypeTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys)

src/Umbraco.Cms.ManagementApi/Controllers/ExamineManagement/ExamineManagementControllerBase.cs

@@ -1,12 +0,0 @@
-using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
-using Umbraco.New.Cms.Web.Common.Routing;
-
-namespace Umbraco.Cms.ManagementApi.Controllers.ExamineManagement;
-
-[ApiController]
-[BackOfficeRoute("api/v{version:apiVersion}/examineManagement")]
-[OpenApiTag("ExamineManagement")]
-public class ExamineManagementControllerBase : ManagementApiControllerBase
-{
-}

src/Umbraco.Cms.ManagementApi/Controllers/ExamineManagement/IndexesExamineManagementController.cs

@@ -1,42 +0,0 @@
-using Examine;
-using Microsoft.AspNetCore.Http;
-using Microsoft.AspNetCore.Mvc;
-using Umbraco.Cms.Infrastructure.Examine;
-using Umbraco.Cms.ManagementApi.Factories;
-using Umbraco.Cms.ManagementApi.ViewModels.ExamineManagement;
-using Umbraco.Cms.ManagementApi.ViewModels.Pagination;
-using Umbraco.Extensions;
-
-namespace Umbraco.Cms.ManagementApi.Controllers.ExamineManagement;
-
-[ApiVersion("1.0")]
-public class IndexesExamineManagementController : ExamineManagementControllerBase
-{
-    private readonly IExamineManager _examineManager;
-    private readonly IExamineIndexViewModelFactory _examineIndexViewModelFactory;
-
-    public IndexesExamineManagementController(
-        IExamineManager examineManager,
-        IExamineIndexViewModelFactory examineIndexViewModelFactory)
-    {
-        _examineManager = examineManager;
-        _examineIndexViewModelFactory = examineIndexViewModelFactory;
-    }
-
-    /// <summary>
-    ///     Get the details for indexers
-    /// </summary>
-    /// <returns></returns>
-    [HttpGet("indexes")]
-    [MapToApiVersion("1.0")]
-    [ProducesResponseType(typeof(PagedViewModel<ExamineIndexViewModel>), StatusCodes.Status200OK)]
-    public async Task<PagedViewModel<ExamineIndexViewModel>> Indexes(int skip, int take)
-    {
-        ExamineIndexViewModel[] indexes = _examineManager.Indexes
-            .Select(_examineIndexViewModelFactory.Create)
-            .OrderBy(examineIndexModel => examineIndexModel.Name?.TrimEnd("Indexer")).ToArray();
-
-        var viewModel = new PagedViewModel<ExamineIndexViewModel> { Items = indexes.Skip(skip).Take(take), Total = indexes.Length };
-        return viewModel;
-    }
-}

src/Umbraco.Cms.ManagementApi/Controllers/Help/HelpControllerBase.cs

@@ -1,12 +1,11 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.New.Cms.Web.Common.Routing;
 
 namespace Umbraco.Cms.ManagementApi.Controllers.Help;
 
 [ApiController]
-[BackOfficeRoute("api/v{version:apiVersion}/help")]
-[OpenApiTag("Help")]
+[VersionedApiBackOfficeRoute("help")]
+[ApiExplorerSettings(GroupName = "Help")]
 [ApiVersion("1.0")]
 public abstract class HelpControllerBase : ManagementApiControllerBase
 {

src/Umbraco.Cms.ManagementApi/Controllers/Indexer/AllIndexerController.cs

@@ -0,0 +1,41 @@
+using Examine;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Umbraco.Cms.ManagementApi.Factories;
+using Umbraco.Cms.ManagementApi.ViewModels.Pagination;
+using Umbraco.Cms.ManagementApi.ViewModels.Search;
+using Umbraco.Extensions;
+
+namespace Umbraco.Cms.ManagementApi.Controllers.Indexer;
+
+[ApiVersion("1.0")]
+public class AllIndexerController : IndexerControllerBase
+{
+    private readonly IExamineManager _examineManager;
+    private readonly IIndexViewModelFactory _indexViewModelFactory;
+
+    public AllIndexerController(
+        IExamineManager examineManager,
+        IIndexViewModelFactory indexViewModelFactory)
+    {
+        _examineManager = examineManager;
+        _indexViewModelFactory = indexViewModelFactory;
+    }
+
+    /// <summary>
+    ///     Get the details for indexers
+    /// </summary>
+    /// <returns></returns>
+    [HttpGet]
+    [MapToApiVersion("1.0")]
+    [ProducesResponseType(typeof(PagedViewModel<IndexViewModel>), StatusCodes.Status200OK)]
+    public Task<PagedViewModel<IndexViewModel>> All(int skip, int take)
+    {
+        IndexViewModel[] indexes = _examineManager.Indexes
+            .Select(_indexViewModelFactory.Create)
+            .OrderBy(indexModel => indexModel.Name.TrimEnd("Indexer")).ToArray();
+
+        var viewModel = new PagedViewModel<IndexViewModel> { Items = indexes.Skip(skip).Take(take), Total = indexes.Length };
+        return Task.FromResult(viewModel);
+    }
+}

src/Umbraco.Cms.ManagementApi/Controllers/Indexer/DetailsIndexerController.cs

@@ -2,21 +2,21 @@
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
 using Umbraco.Cms.ManagementApi.Factories;
-using Umbraco.Cms.ManagementApi.ViewModels.ExamineManagement;
+using Umbraco.Cms.ManagementApi.ViewModels.Search;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.ExamineManagement;
+namespace Umbraco.Cms.ManagementApi.Controllers.Indexer;
 
 [ApiVersion("1.0")]
-public class IndexExamineManagementController : ExamineManagementControllerBase
+public class DetailsIndexerController : IndexerControllerBase
 {
-    private readonly IExamineIndexViewModelFactory _examineIndexViewModelFactory;
+    private readonly IIndexViewModelFactory _indexViewModelFactory;
     private readonly IExamineManager _examineManager;
 
-    public IndexExamineManagementController(
-        IExamineIndexViewModelFactory examineIndexViewModelFactory,
+    public DetailsIndexerController(
+        IIndexViewModelFactory indexViewModelFactory,
         IExamineManager examineManager)
     {
-        _examineIndexViewModelFactory = examineIndexViewModelFactory;
+        _indexViewModelFactory = indexViewModelFactory;
         _examineManager = examineManager;
     }
 
@@ -29,15 +29,15 @@ public class IndexExamineManagementController : ExamineManagementControllerBase
     ///     This is kind of rudimentary since there's no way we can know that the index has rebuilt, we
     ///     have a listener for the index op complete so we'll just check if that key is no longer there in the runtime cache
     /// </remarks>
-    [HttpGet("index")]
+    [HttpGet("{indexName}")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
-    [ProducesResponseType(typeof(ExamineIndexViewModel), StatusCodes.Status200OK)]
-    public async Task<ActionResult<ExamineIndexViewModel?>> Index(string indexName)
+    [ProducesResponseType(typeof(IndexViewModel), StatusCodes.Status200OK)]
+    public async Task<ActionResult<IndexViewModel?>> Details(string indexName)
     {
         if (_examineManager.TryGetIndex(indexName, out IIndex? index))
         {
-            return await Task.FromResult(_examineIndexViewModelFactory.Create(index!));
+            return await Task.FromResult(_indexViewModelFactory.Create(index!));
         }
 
         var invalidModelProblem = new ProblemDetails

src/Umbraco.Cms.ManagementApi/Controllers/Indexer/IndexerControllerBase.cs

@@ -0,0 +1,11 @@
+using Microsoft.AspNetCore.Mvc;
+using Umbraco.New.Cms.Web.Common.Routing;
+
+namespace Umbraco.Cms.ManagementApi.Controllers.Indexer;
+
+[ApiController]
+[VersionedApiBackOfficeRoute("indexer")]
+[ApiExplorerSettings(GroupName = "Indexer")]
+public class IndexerControllerBase : ManagementApiControllerBase
+{
+}

src/Umbraco.Cms.ManagementApi/Controllers/Indexer/RebuildIndexerController.cs

@@ -5,17 +5,17 @@ using Microsoft.Extensions.Logging;
 using Umbraco.Cms.Infrastructure.Examine;
 using Umbraco.New.Cms.Infrastructure.Services;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.ExamineManagement;
+namespace Umbraco.Cms.ManagementApi.Controllers.Indexer;
 
 [ApiVersion("1.0")]
-public class RebuildExamineManagementController : ExamineManagementControllerBase
+public class RebuildIndexerController : IndexerControllerBase
 {
-    private readonly ILogger<RebuildExamineManagementController> _logger;
+    private readonly ILogger<RebuildIndexerController> _logger;
     private readonly IIndexingRebuilderService _indexingRebuilderService;
     private readonly IExamineManager _examineManager;
 
-    public RebuildExamineManagementController(
-        ILogger<RebuildExamineManagementController> logger,
+    public RebuildIndexerController(
+        ILogger<RebuildIndexerController> logger,
         IIndexingRebuilderService indexingRebuilderService,
         IExamineManager examineManager)
     {
@@ -29,7 +29,7 @@ public class RebuildExamineManagementController : ExamineManagementControllerBas
     /// </summary>
     /// <param name="indexName"></param>
     /// <returns></returns>
-    [HttpPost("rebuild")]
+    [HttpPost("{indexName}/rebuild")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(OkResult), StatusCodes.Status200OK)]

src/Umbraco.Cms.ManagementApi/Controllers/Install/InstallControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.ManagementApi.Filters;
 using Umbraco.New.Cms.Web.Common.Routing;
@@ -8,7 +7,7 @@ namespace Umbraco.Cms.ManagementApi.Controllers.Install;
 
 [ApiController]
 [VersionedApiBackOfficeRoute("install")]
-[OpenApiTag("Install")]
+[ApiExplorerSettings(GroupName = "Install")]
 [RequireRuntimeLevel(RuntimeLevel.Install)]
 public abstract class InstallControllerBase : ManagementApiControllerBase
 {

src/Umbraco.Cms.ManagementApi/Controllers/Install/ValidateDatabaseInstallController.cs

@@ -21,7 +21,7 @@ public class ValidateDatabaseInstallController : InstallControllerBase
         _mapper = mapper;
     }
 
-    [HttpPost("validateDatabase")]
+    [HttpPost("validate-database")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(StatusCodes.Status200OK)]

src/Umbraco.Cms.ManagementApi/Controllers/Language/LanguageControllerBase.cs

@@ -1,12 +1,11 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.New.Cms.Web.Common.Routing;
 
 namespace Umbraco.Cms.ManagementApi.Controllers.Language;
 
 [ApiController]
-[BackOfficeRoute("api/v{version:apiVersion}/language")]
-[OpenApiTag("Language")]
+[VersionedApiBackOfficeRoute("language")]
+[ApiExplorerSettings(GroupName = "Language")]
 [ApiVersion("1.0")]
 public abstract class LanguageControllerBase : ManagementApiControllerBase
 {

src/Umbraco.Cms.ManagementApi/Controllers/Media/RecycleBin/MediaRecycleBinControllerBase.cs

@@ -1,6 +1,5 @@
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Models.Entities;
@@ -14,10 +13,10 @@ namespace Umbraco.Cms.ManagementApi.Controllers.Media.RecycleBin;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.Media}/recycle-bin")]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.RecycleBin}/{Constants.UdiEntityType.Media}")]
 [RequireMediaTreeRootAccess]
 [ProducesResponseType(StatusCodes.Status401Unauthorized)]
-[OpenApiTag(nameof(Constants.UdiEntityType.Media))]
+[ApiExplorerSettings(GroupName = nameof(Constants.UdiEntityType.Media))]
 public class MediaRecycleBinControllerBase : RecycleBinControllerBase<RecycleBinItemViewModel>
 {
     public MediaRecycleBinControllerBase(IEntityService entityService)

src/Umbraco.Cms.ManagementApi/Controllers/Media/Tree/ItemsMediaTreeController.cs

@@ -20,7 +20,7 @@ public class ItemsMediaTreeController : MediaTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<ContentTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<ContentTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys, Guid? dataTypeKey = null)

src/Umbraco.Cms.ManagementApi/Controllers/Media/Tree/MediaTreeControllerBase.cs

@@ -1,5 +1,5 @@
-using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Cache;
 using Umbraco.Cms.Core.Models;
@@ -15,8 +15,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.Media.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.Media}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.Media))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.Media}")]
+[ApiExplorerSettings(GroupName = nameof(Constants.UdiEntityType.Media))]
 public class MediaTreeControllerBase : UserStartNodeTreeControllerBase<ContentTreeItemViewModel>
 {
     private readonly AppCaches _appCaches;

src/Umbraco.Cms.ManagementApi/Controllers/MediaType/Tree/ItemsMediaTypeTreeController.cs

@@ -12,7 +12,7 @@ public class ItemsMediaTypeTreeController : MediaTypeTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<FolderTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<FolderTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys)

src/Umbraco.Cms.ManagementApi/Controllers/MediaType/Tree/MediaTypeTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Models.Entities;
@@ -12,8 +11,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.MediaType.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.MediaType}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.MediaType))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.MediaType}")]
+[ApiExplorerSettings(GroupName = "Media Type")]
 public class MediaTypeTreeControllerBase : FolderTreeControllerBase<FolderTreeItemViewModel>
 {
     private readonly IMediaTypeService _mediaTypeService;

src/Umbraco.Cms.ManagementApi/Controllers/MemberGroup/Tree/ItemsMemberGroupTreeController.cs

@@ -12,7 +12,7 @@ public class ItemsMemberGroupTreeController : MemberGroupTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<EntityTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<EntityTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys)

src/Umbraco.Cms.ManagementApi/Controllers/MemberGroup/Tree/MemberGroupTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Models.Entities;
@@ -12,8 +11,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.MemberGroup.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.MemberGroup}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.MemberGroup))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.MemberGroup}")]
+[ApiExplorerSettings(GroupName = "Member Group")]
 public class MemberGroupTreeControllerBase : EntityTreeControllerBase<EntityTreeItemViewModel>
 {
     public MemberGroupTreeControllerBase(IEntityService entityService)

src/Umbraco.Cms.ManagementApi/Controllers/MemberType/Tree/ItemsMemberTypeTreeController.cs

@@ -12,7 +12,7 @@ public class ItemsMemberTypeTreeController : MemberTypeTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<EntityTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<EntityTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys)

src/Umbraco.Cms.ManagementApi/Controllers/MemberType/Tree/MemberTypeTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Models.Entities;
@@ -12,8 +11,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.MemberType.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.MemberType}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.MemberType))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.MemberType}")]
+[ApiExplorerSettings(GroupName = "Member Type")]
 public class MemberTypeTreeControllerBase : EntityTreeControllerBase<EntityTreeItemViewModel>
 {
     public MemberTypeTreeControllerBase(IEntityService entityService)

src/Umbraco.Cms.ManagementApi/Controllers/ModelsBuilder/BuildModelsBuilderController.cs

@@ -8,7 +8,7 @@ using Umbraco.Cms.Infrastructure.ModelsBuilder;
 using Umbraco.Cms.Infrastructure.ModelsBuilder.Building;
 using Umbraco.Extensions;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.ModelsBuilderDashboard;
+namespace Umbraco.Cms.ManagementApi.Controllers.ModelsBuilder;
 
 public class BuildModelsBuilderController : ModelsBuilderControllerBase
 {

src/Umbraco.Cms.ManagementApi/Controllers/ModelsBuilder/GetModelsBuilderController.cs

@@ -1,10 +1,9 @@
-using System.Threading.Tasks;
-using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
 using Umbraco.Cms.ManagementApi.Factories;
 using Umbraco.Cms.ManagementApi.ViewModels.ModelsBuilderDashboard;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.ModelsBuilderDashboard;
+namespace Umbraco.Cms.ManagementApi.Controllers.ModelsBuilder;
 
 public class GetModelsBuilderController : ModelsBuilderControllerBase
 {
@@ -12,8 +11,8 @@ public class GetModelsBuilderController : ModelsBuilderControllerBase
 
     public GetModelsBuilderController(IModelsBuilderViewModelFactory modelsBuilderViewModelFactory) => _modelsBuilderViewModelFactory = modelsBuilderViewModelFactory;
 
-    [HttpGet]
-    [ProducesResponseType(typeof(CreatedResult), StatusCodes.Status200OK)]
+    [HttpGet("dashboard")]
+    [ProducesResponseType(typeof(ModelsBuilderViewModel), StatusCodes.Status200OK)]
     [MapToApiVersion("1.0")]
     public async Task<ActionResult<ModelsBuilderViewModel>> GetDashboard() => await Task.FromResult(Ok(_modelsBuilderViewModelFactory.Create()));
 }

src/Umbraco.Cms.ManagementApi/Controllers/ModelsBuilder/ModelsBuilderControllerBase.cs

@@ -1,12 +1,11 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.New.Cms.Web.Common.Routing;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.ModelsBuilderDashboard;
+namespace Umbraco.Cms.ManagementApi.Controllers.ModelsBuilder;
 
 [ApiController]
-[VersionedApiBackOfficeRoute("modelsBuilder")]
-[OpenApiTag("ModelsBuilder")]
+[VersionedApiBackOfficeRoute("models-builder")]
+[ApiExplorerSettings(GroupName = "Models Builder")]
 [ApiVersion("1.0")]
 
 public class ModelsBuilderControllerBase : ManagementApiControllerBase

src/Umbraco.Cms.ManagementApi/Controllers/ModelsBuilder/StatusModelsBuilderController.cs

@@ -5,7 +5,7 @@ using Umbraco.Cms.Infrastructure.ModelsBuilder;
 using Umbraco.Cms.ManagementApi.ViewModels.ModelsBuilderDashboard;
 using Umbraco.New.Cms.Core.Models;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.ModelsBuilderDashboard;
+namespace Umbraco.Cms.ManagementApi.Controllers.ModelsBuilder;
 
 public class StatusModelsBuilderController : ModelsBuilderControllerBase
 {

src/Umbraco.Cms.ManagementApi/Controllers/PartialView/Tree/ItemsPartialViewTreeController.cs

@@ -12,7 +12,7 @@ public class ItemsPartialViewTreeController : PartialViewTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<FileSystemTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<FileSystemTreeItemViewModel>>> Items([FromQuery(Name = "path")] string[] paths)

src/Umbraco.Cms.ManagementApi/Controllers/PartialView/Tree/PartialViewTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.IO;
 using Umbraco.Cms.ManagementApi.Controllers.Tree;
@@ -9,8 +8,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.PartialView.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.PartialView}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.PartialView))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.PartialView}")]
+[ApiExplorerSettings(GroupName = "Partial View")]
 public class PartialViewTreeControllerBase : FileSystemTreeControllerBase
 {
     public PartialViewTreeControllerBase(FileSystems fileSystems)

src/Umbraco.Cms.ManagementApi/Controllers/Profiling/ProfilingControllerBase.cs

@@ -1,13 +1,12 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.New.Cms.Web.Common.Routing;
 
 namespace Umbraco.Cms.ManagementApi.Controllers.Profiling;
 
 [ApiVersion("1.0")]
 [ApiController]
-[BackOfficeRoute("api/v{version:apiVersion}/profiling")]
-[OpenApiTag("Profiling")]
+[VersionedApiBackOfficeRoute("profiling")]
+[ApiExplorerSettings(GroupName = "Profiling")]
 public class ProfilingControllerBase : ManagementApiControllerBase
 {
 }

src/Umbraco.Cms.ManagementApi/Controllers/PublishedCache/PublishedCacheControllerBase.cs

@@ -1,13 +1,12 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.New.Cms.Web.Common.Routing;
 
 namespace Umbraco.Cms.ManagementApi.Controllers.PublishedCache;
 
 [ApiVersion("1.0")]
 [ApiController]
-[BackOfficeRoute("api/v{version:apiVersion}/published-cache")]
-[OpenApiTag("PublishedCache")]
+[VersionedApiBackOfficeRoute("published-cache")]
+[ApiExplorerSettings(GroupName = "Published Cache")]
 public class PublishedCacheControllerBase : ManagementApiControllerBase
 {
 }

src/Umbraco.Cms.ManagementApi/Controllers/PublishedCache/RebuildPublishedCacheController.cs

@@ -14,7 +14,7 @@ public class RebuildPublishedCacheController : PublishedCacheControllerBase
     [HttpPost("rebuild")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(StatusCodes.Status200OK)]
-    public async Task<ActionResult> Collect()
+    public async Task<ActionResult> Rebuild()
     {
         _publishedSnapshotService.Rebuild();
         return await Task.FromResult(Ok());

src/Umbraco.Cms.ManagementApi/Controllers/Relation/ByChildRelationController.cs

@@ -22,7 +22,7 @@ public class ByChildRelationController : RelationControllerBase
         _relationViewModelFactory = relationViewModelFactory;
     }
 
-    [HttpGet("childRelations/{childId:int}")]
+    [HttpGet("child-relation/{childId:int}")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PagedViewModel<RelationViewModel>), StatusCodes.Status200OK)]
     public async Task<PagedViewModel<RelationViewModel>> ByChild(int childId, int skip, int take, string? relationTypeAlias = "")

src/Umbraco.Cms.ManagementApi/Controllers/Relation/RelationControllerBase.cs

@@ -1,12 +1,11 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.New.Cms.Web.Common.Routing;
 
 namespace Umbraco.Cms.ManagementApi.Controllers.Relation;
 
 [ApiController]
-[BackOfficeRoute("api/v{version:apiVersion}/relation")]
-[OpenApiTag("Relation")]
+[VersionedApiBackOfficeRoute("relation")]
+[ApiExplorerSettings(GroupName = "Relation")]
 [ApiVersion("1.0")]
 // TODO: Implement Authentication
 public abstract class RelationControllerBase : ManagementApiControllerBase

src/Umbraco.Cms.ManagementApi/Controllers/RelationType/Tree/ItemsRelationTypeTreeController.cs

@@ -14,7 +14,7 @@ public class ItemsRelationTypeTreeController : RelationTypeTreeControllerBase
         : base(entityService) =>
         _relationService = relationService;
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<FolderTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<FolderTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys)

src/Umbraco.Cms.ManagementApi/Controllers/RelationType/Tree/RelationTypeTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Services;
@@ -11,8 +10,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.RelationType.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.RelationType}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.RelationType))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.RelationType}")]
+[ApiExplorerSettings(GroupName = "Relation Type")]
 // NOTE: at the moment relation types aren't supported by EntityService, so we have little use of the
 // tree controller base. We'll keep it though, in the hope that we can mend EntityService.
 public class RelationTypeTreeControllerBase : EntityTreeControllerBase<EntityTreeItemViewModel>

src/Umbraco.Cms.ManagementApi/Controllers/Script/Tree/ItemsScriptTreeController.cs

@@ -12,7 +12,7 @@ public class ItemsScriptTreeController : ScriptTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<FileSystemTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<FileSystemTreeItemViewModel>>> Items([FromQuery(Name = "path")] string[] paths)

src/Umbraco.Cms.ManagementApi/Controllers/Script/Tree/ScriptTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.IO;
 using Umbraco.Cms.ManagementApi.Controllers.Tree;
@@ -9,8 +8,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.Script.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.Script}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.Script))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.Script}")]
+[ApiExplorerSettings(GroupName = nameof(Constants.UdiEntityType.Script))]
 public class ScriptTreeControllerBase : FileSystemTreeControllerBase
 {
     public ScriptTreeControllerBase(FileSystems fileSystems)

src/Umbraco.Cms.ManagementApi/Controllers/Searcher/AllSearcherController.cs

@@ -1,28 +1,27 @@
 using Examine;
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
-using Umbraco.Cms.Infrastructure.Examine;
-using Umbraco.Cms.ManagementApi.ViewModels.ExamineManagement;
 using Umbraco.Cms.ManagementApi.ViewModels.Pagination;
+using Umbraco.Cms.ManagementApi.ViewModels.Search;
 using Umbraco.Extensions;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.ExamineManagement;
+namespace Umbraco.Cms.ManagementApi.Controllers.Searcher;
 
 [ApiVersion("1.0")]
-public class SearchersExamineManagementController : ExamineManagementControllerBase
+public class AllSearcherController : SearcherControllerBase
 {
     private readonly IExamineManager _examineManager;
 
-    public SearchersExamineManagementController(IExamineManager examineManager) => _examineManager = examineManager;
+    public AllSearcherController(IExamineManager examineManager) => _examineManager = examineManager;
 
     /// <summary>
     ///     Get the details for searchers
     /// </summary>
     /// <returns></returns>
-    [HttpGet("searchers")]
+    [HttpGet]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PagedViewModel<SearcherViewModel>), StatusCodes.Status200OK)]
-    public async Task<ActionResult<PagedViewModel<SearcherViewModel>>> Searchers(int skip, int take)
+    public async Task<ActionResult<PagedViewModel<SearcherViewModel>>> All(int skip, int take)
     {
         var searchers = new List<SearcherViewModel>(
             _examineManager.RegisteredSearchers.Select(searcher => new SearcherViewModel { Name = searcher.Name })

src/Umbraco.Cms.ManagementApi/Controllers/Searcher/QuerySearcherController.cs

@@ -4,28 +4,28 @@ using Lucene.Net.QueryParsers.Classic;
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
 using Umbraco.Cms.ManagementApi.Services;
-using Umbraco.Cms.ManagementApi.ViewModels.ExamineManagement;
 using Umbraco.Cms.ManagementApi.ViewModels.Pagination;
+using Umbraco.Cms.ManagementApi.ViewModels.Search;
 using Umbraco.Extensions;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.ExamineManagement;
+namespace Umbraco.Cms.ManagementApi.Controllers.Searcher;
 
 [ApiVersion("1.0")]
-public class SearchExamineManagementController : ExamineManagementControllerBase
+public class QuerySearcherController : SearcherControllerBase
 {
     private readonly IExamineManagerService _examineManagerService;
 
-    public SearchExamineManagementController(IExamineManagerService examineManagerService) => _examineManagerService = examineManagerService;
+    public QuerySearcherController(IExamineManagerService examineManagerService) => _examineManagerService = examineManagerService;
 
-    [HttpGet("search")]
+    [HttpGet("{searcherName}/query")]
     [MapToApiVersion("1.0")]
-    [ProducesResponseType(typeof(PagedViewModel<PagedViewModel<SearchResultViewModel>>), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(PagedViewModel<SearchResultViewModel>), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    public async Task<ActionResult<PagedViewModel<SearchResultViewModel>>> GetSearchResults(string searcherName, string? query, int skip, int take)
+    public async Task<ActionResult<PagedViewModel<SearchResultViewModel>>> Query(string searcherName, string? term, int skip, int take)
     {
-        query = query?.Trim();
+        term = term?.Trim();
 
-        if (query.IsNullOrWhiteSpace())
+        if (term.IsNullOrWhiteSpace())
         {
             return new PagedViewModel<SearchResultViewModel>();
         }
@@ -50,7 +50,7 @@ public class SearchExamineManagementController : ExamineManagementControllerBase
         {
             results = searcher
                 .CreateQuery()
-                .NativeQuery(query)
+                .NativeQuery(term)
                 .Execute(QueryOptions.SkipTake(skip, take));
         }
         catch (ParseException)

src/Umbraco.Cms.ManagementApi/Controllers/Searcher/SearcherControllerBase.cs

@@ -0,0 +1,11 @@
+using Microsoft.AspNetCore.Mvc;
+using Umbraco.New.Cms.Web.Common.Routing;
+
+namespace Umbraco.Cms.ManagementApi.Controllers.Searcher;
+
+[ApiController]
+[VersionedApiBackOfficeRoute("searcher")]
+[ApiExplorerSettings(GroupName = "Searcher")]
+public class SearcherControllerBase : ManagementApiControllerBase
+{
+}

src/Umbraco.Cms.ManagementApi/Controllers/Security/BackOfficeController.cs

@@ -0,0 +1,144 @@
+using System.Security.Claims;
+using Microsoft.AspNetCore;
+using Microsoft.AspNetCore.Authentication;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Identity;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Options;
+using OpenIddict.Abstractions;
+using OpenIddict.Server.AspNetCore;
+using Umbraco.Cms.Core;
+using Umbraco.Cms.Core.Configuration.Models;
+using Umbraco.Cms.Core.Security;
+using Umbraco.Cms.Web.BackOffice.Security;
+using Umbraco.Extensions;
+using Umbraco.New.Cms.Web.Common.Routing;
+using SignInResult = Microsoft.AspNetCore.Mvc.SignInResult;
+using IdentitySignInResult = Microsoft.AspNetCore.Identity.SignInResult;
+
+namespace Umbraco.Cms.ManagementApi.Controllers.Security;
+
+[ApiController]
+[VersionedApiBackOfficeRoute(Paths.BackOfficeApiEndpointTemplate)]
+[ApiExplorerSettings(GroupName = "Security")]
+public class BackOfficeController : ManagementApiControllerBase
+{
+    private readonly IHttpContextAccessor _httpContextAccessor;
+    private readonly IBackOfficeSignInManager _backOfficeSignInManager;
+    private readonly IBackOfficeUserManager _backOfficeUserManager;
+    private readonly IOptions<SecuritySettings> _securitySettings;
+
+    public BackOfficeController(
+        IHttpContextAccessor httpContextAccessor,
+        IBackOfficeSignInManager backOfficeSignInManager,
+        IBackOfficeUserManager backOfficeUserManager,
+        IOptions<SecuritySettings> securitySettings)
+    {
+        _httpContextAccessor = httpContextAccessor;
+        _backOfficeSignInManager = backOfficeSignInManager;
+        _backOfficeUserManager = backOfficeUserManager;
+        _securitySettings = securitySettings;
+    }
+
+    [HttpGet("authorize")]
+    [HttpPost("authorize")]
+    [MapToApiVersion("1.0")]
+    public async Task<IActionResult> Authorize()
+    {
+        HttpContext context = _httpContextAccessor.GetRequiredHttpContext();
+        OpenIddictRequest? request = context.GetOpenIddictServerRequest();
+        if (request == null)
+        {
+            return BadRequest("Unable to obtain OpenID data from the current request");
+        }
+
+        return request.IdentityProvider.IsNullOrWhiteSpace()
+            ? await AuthorizeInternal(request)
+            : await AuthorizeExternal(request);
+    }
+
+    private async Task<IActionResult> AuthorizeInternal(OpenIddictRequest request)
+    {
+        // TODO: ensure we handle sign-in notifications for internal logins.
+        // when the new login screen is implemented for internal logins, make sure it still handles
+        // user sign-in notifications (calls BackOfficeSignInManager.HandleSignIn) as part of the
+        // sign-in process
+        // for future reference, notifications are already handled for the external login flow by
+        // by calling BackOfficeSignInManager.ExternalLoginSignInAsync
+
+        // retrieve the user principal stored in the authentication cookie.
+        AuthenticateResult cookieAuthResult = await HttpContext.AuthenticateAsync(Constants.Security.BackOfficeAuthenticationType);
+        var userName = cookieAuthResult.Succeeded
+            ? cookieAuthResult.Principal?.Identity?.Name
+            : null;
+
+        if (userName != null)
+        {
+            BackOfficeIdentityUser? backOfficeUser = await _backOfficeUserManager.FindByNameAsync(userName);
+            if (backOfficeUser != null)
+            {
+                return await SignInBackOfficeUser(backOfficeUser, request);
+            }
+        }
+
+        return DefaultChallengeResult();
+    }
+
+    private async Task<IActionResult> AuthorizeExternal(OpenIddictRequest request)
+    {
+        var provider = request.IdentityProvider ?? throw new ArgumentException("No identity provider found in request", nameof(request));
+
+        ExternalLoginInfo? loginInfo = await _backOfficeSignInManager.GetExternalLoginInfoAsync();
+        if (loginInfo?.Principal != null)
+        {
+            IdentitySignInResult result = await _backOfficeSignInManager.ExternalLoginSignInAsync(loginInfo, false, _securitySettings.Value.UserBypassTwoFactorForExternalLogins);
+
+            if (result.Succeeded)
+            {
+                // Update any authentication tokens if succeeded
+                await _backOfficeSignInManager.UpdateExternalAuthenticationTokensAsync(loginInfo);
+
+                // sign in the backoffice user associated with the login provider and unique provider key
+                BackOfficeIdentityUser? backOfficeUser = await _backOfficeUserManager.FindByLoginAsync(loginInfo.LoginProvider, loginInfo.ProviderKey);
+                if (backOfficeUser != null)
+                {
+                    return await SignInBackOfficeUser(backOfficeUser, request);
+                }
+            }
+            else
+            {
+                // avoid infinite auth loops when something fails by performing the default challenge (default login screen)
+                return DefaultChallengeResult();
+            }
+        }
+
+        AuthenticationProperties properties = _backOfficeSignInManager.ConfigureExternalAuthenticationProperties(provider, null);
+        return new ChallengeResult(provider, properties);
+    }
+
+    private async Task<IActionResult> SignInBackOfficeUser(BackOfficeIdentityUser backOfficeUser, OpenIddictRequest request)
+    {
+        ClaimsPrincipal backOfficePrincipal = await _backOfficeSignInManager.CreateUserPrincipalAsync(backOfficeUser);
+        backOfficePrincipal.SetClaim(OpenIddictConstants.Claims.Subject, backOfficeUser.Key.ToString());
+
+        // TODO: it is not optimal to append all claims to the token.
+        // the token size grows with each claim, although it is still smaller than the old cookie.
+        // see if we can find a better way so we do not risk leaking sensitive data in bearer tokens.
+        // maybe work with scopes instead?
+        Claim[] backOfficeClaims = backOfficePrincipal.Claims.ToArray();
+        foreach (Claim backOfficeClaim in backOfficeClaims)
+        {
+            backOfficeClaim.SetDestinations(OpenIddictConstants.Destinations.AccessToken);
+        }
+
+        if (request.GetScopes().Contains(OpenIddictConstants.Scopes.OfflineAccess))
+        {
+            // "offline_access" scope is required to use refresh tokens
+            backOfficePrincipal.SetScopes(OpenIddictConstants.Scopes.OfflineAccess);
+        }
+
+        return new SignInResult(OpenIddictServerAspNetCoreDefaults.AuthenticationScheme, backOfficePrincipal);
+    }
+
+    private static IActionResult DefaultChallengeResult() => new ChallengeResult(Constants.Security.BackOfficeAuthenticationType);
+}

src/Umbraco.Cms.ManagementApi/Controllers/Security/Paths.cs

@@ -0,0 +1,12 @@
+namespace Umbraco.Cms.ManagementApi.Controllers.Security;
+
+public static class Paths
+{
+    public const string BackOfficeApiEndpointTemplate = "security/back-office";
+
+    public static readonly string BackOfficeApiAuthorizationEndpoint = BackOfficeApiEndpointPath($"{BackOfficeApiEndpointTemplate}/authorize");
+
+    public static readonly string BackOfficeApiTokenEndpoint = BackOfficeApiEndpointPath($"{BackOfficeApiEndpointTemplate}/token");
+
+    private static string BackOfficeApiEndpointPath(string relativePath) => $"/umbraco/management/api/v1.0/{relativePath}";
+}

src/Umbraco.Cms.ManagementApi/Controllers/Server/ServerControllerBase.cs

@@ -1,12 +1,11 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.New.Cms.Web.Common.Routing;
 
 namespace Umbraco.Cms.ManagementApi.Controllers.Server;
 
 [ApiController]
 [VersionedApiBackOfficeRoute("server")]
-[OpenApiTag("Server")]
+[ApiExplorerSettings(GroupName = "Server")]
 public abstract class ServerControllerBase : ManagementApiControllerBase
 {
 

src/Umbraco.Cms.ManagementApi/Controllers/StaticFile/Tree/ItemsStaticFileTreeController.cs

@@ -12,7 +12,7 @@ public class ItemsStaticFileTreeController : StaticFileTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<FileSystemTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<FileSystemTreeItemViewModel>>> Items([FromQuery(Name = "path")] string[] paths)

src/Umbraco.Cms.ManagementApi/Controllers/StaticFile/Tree/StaticFileTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.IO;
 using Umbraco.Cms.ManagementApi.Controllers.Tree;
@@ -9,8 +8,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.StaticFile.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute("static-file/tree")]
-[OpenApiTag("StaticFile")]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/static-file")]
+[ApiExplorerSettings(GroupName = "Static File")]
 public class StaticFileTreeControllerBase : FileSystemTreeControllerBase
 {
     private static readonly string[] _allowedRootFolders = { "App_Plugins", "wwwroot" };

src/Umbraco.Cms.ManagementApi/Controllers/Stylesheet/Tree/ItemsStylesheetTreeController.cs

@@ -12,7 +12,7 @@ public class ItemsStylesheetTreeController : StylesheetTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<FileSystemTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<FileSystemTreeItemViewModel>>> Items([FromQuery(Name = "path")] string[] paths)

src/Umbraco.Cms.ManagementApi/Controllers/Stylesheet/Tree/StylesheetTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.IO;
 using Umbraco.Cms.ManagementApi.Controllers.Tree;
@@ -9,8 +8,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.Stylesheet.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.Stylesheet}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.Stylesheet))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.Stylesheet}")]
+[ApiExplorerSettings(GroupName = nameof(Constants.UdiEntityType.Stylesheet))]
 public class StylesheetTreeControllerBase : FileSystemTreeControllerBase
 {
     public StylesheetTreeControllerBase(FileSystems fileSystems)

src/Umbraco.Cms.ManagementApi/Controllers/Telemetry/AllTelemetryController.cs

@@ -0,0 +1,23 @@
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Umbraco.Cms.Core.Models;
+using Umbraco.Cms.ManagementApi.ViewModels.Pagination;
+using Umbraco.Cms.ManagementApi.ViewModels.Telemetry;
+
+namespace Umbraco.Cms.ManagementApi.Controllers.Telemetry;
+
+public class AllTelemetryController : TelemetryControllerBase
+{
+    [HttpGet]
+    [MapToApiVersion("1.0")]
+    [ProducesResponseType(typeof(PagedViewModel<TelemetryViewModel>), StatusCodes.Status200OK)]
+    public async Task<PagedViewModel<TelemetryViewModel>> GetAll(int skip, int take)
+    {
+        TelemetryLevel[] levels = Enum.GetValues<TelemetryLevel>();
+        return await Task.FromResult(new PagedViewModel<TelemetryViewModel>
+        {
+            Total = levels.Length,
+            Items = levels.Skip(skip).Take(take).Select(level => new TelemetryViewModel { TelemetryLevel = level }),
+        });
+    }
+}

src/Umbraco.Cms.ManagementApi/Controllers/Telemetry/GetTelemetryController.cs

@@ -0,0 +1,18 @@
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Umbraco.Cms.Core.Services;
+using Umbraco.Cms.ManagementApi.ViewModels.Telemetry;
+
+namespace Umbraco.Cms.ManagementApi.Controllers.Telemetry;
+
+public class GetTelemetryController : TelemetryControllerBase
+{
+    private readonly IMetricsConsentService _metricsConsentService;
+
+    public GetTelemetryController(IMetricsConsentService metricsConsentService) => _metricsConsentService = metricsConsentService;
+
+    [HttpGet("level")]
+    [MapToApiVersion("1.0")]
+    [ProducesResponseType(typeof(TelemetryViewModel), StatusCodes.Status200OK)]
+    public async Task<TelemetryViewModel> Get() => await Task.FromResult(new TelemetryViewModel { TelemetryLevel = _metricsConsentService.GetConsentLevel() });
+}

src/Umbraco.Cms.ManagementApi/Controllers/Telemetry/SetTelemetryController.cs

@@ -1,36 +1,35 @@
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
 using Umbraco.Cms.Core.Services;
-using Umbraco.Cms.ManagementApi.ViewModels.Analytics;
-using Umbraco.Cms.ManagementApi.ViewModels.Server;
+using Umbraco.Cms.ManagementApi.ViewModels.Telemetry;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.Analytics;
+namespace Umbraco.Cms.ManagementApi.Controllers.Telemetry;
 
-public class SetAnalyticsController : AnalyticsControllerBase
+public class SetTelemetryController : TelemetryControllerBase
 {
     private readonly IMetricsConsentService _metricsConsentService;
 
-    public SetAnalyticsController(IMetricsConsentService metricsConsentService) => _metricsConsentService = metricsConsentService;
+    public SetTelemetryController(IMetricsConsentService metricsConsentService) => _metricsConsentService = metricsConsentService;
 
-    [HttpPost]
+    [HttpPost("level")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(StatusCodes.Status200OK)]
-    public async Task<IActionResult> SetConsentLevel(AnalyticsLevelViewModel analyticsLevelViewModel)
+    public async Task<IActionResult> SetConsentLevel(TelemetryViewModel telemetryViewModel)
     {
-        if (!Enum.IsDefined(analyticsLevelViewModel.AnalyticsLevel))
+        if (!Enum.IsDefined(telemetryViewModel.TelemetryLevel))
         {
             var invalidModelProblem = new ProblemDetails
             {
-                Title = "Invalid AnalyticsLevel value",
-                Detail = "The provided value for AnalyticsLevel is not valid",
+                Title = "Invalid TelemetryLevel value",
+                Detail = "The provided value for TelemetryLevel is not valid",
                 Status = StatusCodes.Status400BadRequest,
                 Type = "Error",
             };
             return BadRequest(invalidModelProblem);
         }
 
-        _metricsConsentService.SetConsentLevel(analyticsLevelViewModel.AnalyticsLevel);
+        _metricsConsentService.SetConsentLevel(telemetryViewModel.TelemetryLevel);
         return await Task.FromResult(Ok());
     }
 }

src/Umbraco.Cms.ManagementApi/Controllers/Telemetry/TelemetryControllerBase.cs

@@ -0,0 +1,12 @@
+using Microsoft.AspNetCore.Mvc;
+using Umbraco.New.Cms.Web.Common.Routing;
+
+namespace Umbraco.Cms.ManagementApi.Controllers.Telemetry;
+
+[ApiController]
+[VersionedApiBackOfficeRoute("telemetry")]
+[ApiExplorerSettings(GroupName = "Telemetry")]
+[ApiVersion("1.0")]
+public abstract class TelemetryControllerBase : ManagementApiControllerBase
+{
+}

src/Umbraco.Cms.ManagementApi/Controllers/Template/Tree/ItemsTemplateTreeController.cs

@@ -12,7 +12,7 @@ public class ItemsTemplateTreeController : TemplateTreeControllerBase
     {
     }
 
-    [HttpGet("items")]
+    [HttpGet("item")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<EntityTreeItemViewModel>), StatusCodes.Status200OK)]
     public async Task<ActionResult<IEnumerable<EntityTreeItemViewModel>>> Items([FromQuery(Name = "key")] Guid[] keys)

src/Umbraco.Cms.ManagementApi/Controllers/Template/Tree/TemplateTreeControllerBase.cs

@@ -1,5 +1,4 @@
 using Microsoft.AspNetCore.Mvc;
-using NSwag.Annotations;
 using Umbraco.Cms.Core;
 using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Models.Entities;
@@ -12,8 +11,8 @@ namespace Umbraco.Cms.ManagementApi.Controllers.Template.Tree;
 
 [ApiVersion("1.0")]
 [ApiController]
-[VersionedApiBackOfficeRoute($"{Constants.UdiEntityType.Template}/tree")]
-[OpenApiTag(nameof(Constants.UdiEntityType.Template))]
+[VersionedApiBackOfficeRoute($"{Constants.Web.RoutePath.Tree}/{Constants.UdiEntityType.Template}")]
+[ApiExplorerSettings(GroupName = nameof(Constants.UdiEntityType.Template))]
 public class TemplateTreeControllerBase : EntityTreeControllerBase<EntityTreeItemViewModel>
 {
     public TemplateTreeControllerBase(IEntityService entityService)

src/Umbraco.Cms.ManagementApi/Controllers/TrackedReference/ByIdTrackedReferenceController.cs

@@ -7,14 +7,14 @@ using Umbraco.Cms.ManagementApi.ViewModels.Pagination;
 using Umbraco.Cms.ManagementApi.ViewModels.TrackedReferences;
 using Umbraco.New.Cms.Core.Models;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.TrackedReferences;
+namespace Umbraco.Cms.ManagementApi.Controllers.TrackedReference;
 
-public class ForItemTrackedReferencesController : TrackedReferencesControllerBase
+public class ByIdTrackedReferenceController : TrackedReferenceControllerBase
 {
     private readonly ITrackedReferencesService _trackedReferencesService;
     private readonly IUmbracoMapper _umbracoMapper;
 
-    public ForItemTrackedReferencesController(ITrackedReferencesService trackedReferencesService, IUmbracoMapper umbracoMapper)
+    public ByIdTrackedReferenceController(ITrackedReferencesService trackedReferencesService, IUmbracoMapper umbracoMapper)
     {
         _trackedReferencesService = trackedReferencesService;
         _umbracoMapper = umbracoMapper;

src/Umbraco.Cms.ManagementApi/Controllers/TrackedReference/DescendantsTrackedReferenceController.cs

@@ -7,14 +7,14 @@ using Umbraco.Cms.ManagementApi.ViewModels.Pagination;
 using Umbraco.Cms.ManagementApi.ViewModels.TrackedReferences;
 using Umbraco.New.Cms.Core.Models;
 
-namespace Umbraco.Cms.ManagementApi.Controllers.TrackedReferences;
+namespace Umbraco.Cms.ManagementApi.Controllers.TrackedReference;
 
-public class DescendantsTrackedReferencesController : TrackedReferencesControllerBase
+public class DescendantsTrackedReferenceController : TrackedReferenceControllerBase
 {
     private readonly ITrackedReferencesService _trackedReferencesSkipTakeService;
     private readonly IUmbracoMapper _umbracoMapper;
 
-    public DescendantsTrackedReferencesController(ITrackedReferencesService trackedReferencesSkipTakeService, IUmbracoMapper umbracoMapper)
+    public DescendantsTrackedReferenceController(ITrackedReferencesService trackedReferencesSkipTakeService, IUmbracoMapper umbracoMapper)
     {
         _trackedReferencesSkipTakeService = trackedReferencesSkipTakeService;
         _umbracoMapper = umbracoMapper;