fix several openapi errors

scm-webapp/src/main/java/sonia/scm/api/v2/resources/BranchRootResource.java

@@ -2,7 +2,6 @@ package sonia.scm.api.v2.resources;
 
 import com.google.common.base.Strings;
 import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.headers.Header;
 import io.swagger.v3.oas.annotations.media.Content;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
@@ -180,14 +179,7 @@ public class BranchRootResource {
   @Path("")
   @Consumes(VndMediaType.BRANCH_REQUEST)
   @Operation(summary = "Create branch", description = "Creates a new branch.", tags = "Repository")
-  @ApiResponse(
-    responseCode = "201",
-    description = "create success",
-    headers = @Header(
-      name = "Location",
-      description = "uri to the created branch"
-    )
-  )
+  @ApiResponse(responseCode = "201", description = "create success")
   @ApiResponse(responseCode = "401", description = "not authenticated / invalid credentials")
   @ApiResponse(responseCode = "403", description = "not authorized, the current user does not have the \"push\" privilege")
   @ApiResponse(responseCode = "409", description = "conflict, a branch with this name already exists")

scm-webapp/src/main/java/sonia/scm/api/v2/resources/GroupCollectionResource.java

@@ -1,7 +1,6 @@
 package sonia.scm.api.v2.resources;
 
 import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.headers.Header;
 import io.swagger.v3.oas.annotations.media.Content;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
@@ -95,15 +94,8 @@ public class GroupCollectionResource {
   @POST
   @Path("")
   @Consumes(VndMediaType.GROUP)
-  @Operation(summary = "Create group", description = "Creates a new group.", tags = "Group")
-  @ApiResponse(
-    responseCode = "201",
-    description = "create success",
-    headers = @Header(
-      name = "Location",
-      description = "uri to the created group"
-    )
-  )
+  @Operation(summary = "Create group", description = "Creates a new group.", tags = "Group", operationId = "group_create")
+  @ApiResponse(responseCode = "201", description = "create success")
   @ApiResponse(responseCode = "401", description = "not authenticated / invalid credentials")
   @ApiResponse(responseCode = "403", description = "not authorized, the current user does not have the \"group\" privilege")
   @ApiResponse(responseCode = "409", description = "conflict, a group with this name already exists")

scm-webapp/src/main/java/sonia/scm/api/v2/resources/RepositoryCollectionResource.java

@@ -1,7 +1,6 @@
 package sonia.scm.api.v2.resources;
 
 import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.headers.Header;
 import io.swagger.v3.oas.annotations.media.Content;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
@@ -104,14 +103,7 @@ public class RepositoryCollectionResource {
   @Path("")
   @Consumes(VndMediaType.REPOSITORY)
   @Operation(summary = "Create repository", description = "Creates a new repository.", tags = "Repository")
-  @ApiResponse(
-    responseCode = "201",
-    description = "create success",
-    headers = @Header(
-      name = "Location",
-      description = "uri to the created repository"
-    )
-  )
+  @ApiResponse(responseCode = "201", description = "create success")
   @ApiResponse(responseCode = "401", description = "not authenticated / invalid credentials")
   @ApiResponse(responseCode = "403", description = "not authorized, the current user does not have the \"repository\" privilege")
   @ApiResponse(responseCode = "409", description = "conflict, a repository with this name already exists")

scm-webapp/src/main/java/sonia/scm/api/v2/resources/RepositoryPermissionRootResource.java

@@ -1,7 +1,6 @@
 package sonia.scm.api.v2.resources;
 
 import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.headers.Header;
 import io.swagger.v3.oas.annotations.media.Content;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
@@ -9,9 +8,9 @@ import lombok.extern.slf4j.Slf4j;
 import sonia.scm.AlreadyExistsException;
 import sonia.scm.NotFoundException;
 import sonia.scm.repository.NamespaceAndName;
-import sonia.scm.repository.RepositoryPermission;
 import sonia.scm.repository.Repository;
 import sonia.scm.repository.RepositoryManager;
+import sonia.scm.repository.RepositoryPermission;
 import sonia.scm.repository.RepositoryPermissions;
 import sonia.scm.web.VndMediaType;
 
@@ -68,11 +67,7 @@ public class RepositoryPermissionRootResource {
   @Path("")
   @Consumes(VndMediaType.REPOSITORY_PERMISSION)
   @Operation(summary = "Create repository-specific permission", description = "Adds a new permission to the user or group managed by the repository.", tags = {"Repository", "Permissions"})
-  @ApiResponse(
-    responseCode = "201",
-    description = "creates",
-    headers = @Header(name = "Location", description = "uri of the created permission")
-  )
+  @ApiResponse(responseCode = "201", description = "creates")
   @ApiResponse(
     responseCode = "404",
     description = "not found",

scm-webapp/src/main/java/sonia/scm/api/v2/resources/RepositoryRoleCollectionResource.java

@@ -1,7 +1,6 @@
 package sonia.scm.api.v2.resources;
 
 import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.headers.Header;
 import io.swagger.v3.oas.annotations.media.Content;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
@@ -91,14 +90,7 @@ public class RepositoryRoleCollectionResource {
   @Path("")
   @Consumes(VndMediaType.REPOSITORY_ROLE)
   @Operation(summary = "Create repository role", description = "Creates a new repository role.", tags = "Repository role")
-  @ApiResponse(
-    responseCode = "201",
-    description = "create success",
-    headers = @Header(
-      name = "Location",
-      description = "uri to the created repository role"
-    )
-  )
+  @ApiResponse(responseCode = "201", description = "create success")
   @ApiResponse(responseCode = "401", description = "not authenticated / invalid credentials")
   @ApiResponse(responseCode = "403", description = "not authorized, the current user does not have the \"repositoryRole\" privilege")
   @ApiResponse(responseCode = "409", description = "conflict, a repository role with this name already exists")

scm-webapp/src/main/java/sonia/scm/api/v2/resources/UserCollectionResource.java

@@ -1,7 +1,6 @@
 package sonia.scm.api.v2.resources;
 
 import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.headers.Header;
 import io.swagger.v3.oas.annotations.media.Content;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
@@ -100,14 +99,7 @@ public class UserCollectionResource {
   @Path("")
   @Consumes(VndMediaType.USER)
   @Operation(summary = "Create user", description = "Creates a new user.", tags = "User")
-  @ApiResponse(
-    responseCode = "201",
-    description = "create success",
-    headers = @Header(
-      name = "Location",
-      description = "uri to the created user"
-    )
-  )
+  @ApiResponse(responseCode = "201", description = "create success")
   @ApiResponse(responseCode = "401", description = "not authenticated / invalid credentials")
   @ApiResponse(responseCode = "403", description = "not authorized, the current user does not have the \"user\" privilege")
   @ApiResponse(responseCode = "409", description = "conflict, a user with this name already exists")