feat(authorization): add multi API version support (#5499)

relates to STACKITSDK-330

Co-authored-by: Ruben Hoenle <Ruben.Hoenle@stackit.cloud>

Author: stackit-pipeline

CHANGELOG.md

@@ -104,6 +104,11 @@
   - `v1api`: New package which should be used for communication with the STACKIT mariadb API in the future
   - **Deprecation:** The contents in the root of this SDK module including the `wait` package are marked as deprecated and will be removed after 2026-09-30. Switch to the new `v0api` package instead.
   - **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
+- `authorization`: [v0.13.0](services/authorization/CHANGELOG.md#v0130)
+  - **Feature:** Introduction of multi API version support for the authorization SDK module. For more details please see the announcement on GitHub: https://github.com/stackitcloud/stackit-sdk-go/discussions/5062
+  - `v2api`: New package which should be used for communication with the STACKIT authorization API in the future
+  - **Deprecation:** The contents in the root of this SDK module including the `wait` package are marked as deprecated and will be removed after 2026-09-30. Switch to the new `v2api` package instead.
+  - **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
 
 ## Release (2026-02-20)
 - `core`: [v0.21.1](core/CHANGELOG.md#v0211) 

examples/authorization/authorization.go

@@ -5,8 +5,7 @@ import (
 	"fmt"
 	"os"
 
-	"github.com/stackitcloud/stackit-sdk-go/core/utils"
-	"github.com/stackitcloud/stackit-sdk-go/services/authorization"
+	authorization "github.com/stackitcloud/stackit-sdk-go/services/authorization/v2api"
 )
 
 func main() {
@@ -22,53 +21,53 @@ func main() {
 	}
 
 	// Get the available permissions for the project resource type
-	getPermissionsResp, err := client.ListPermissions(context.Background()).ResourceType("project").Execute()
+	getPermissionsResp, err := client.DefaultAPI.ListPermissions(context.Background()).ResourceType("project").Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Error when calling `GetPermissions`: %v\n", err)
 	} else {
-		availablePermissions := *getPermissionsResp.Permissions
+		availablePermissions := getPermissionsResp.Permissions
 		if len(availablePermissions) > 0 {
-			fmt.Printf("Example of available permission: %v\n", *availablePermissions[0].Name)
+			fmt.Printf("Example of available permission: %v\n", availablePermissions[0].Name)
 		}
 	}
 
 	// Get the memberships of your user
-	getMembershipsResp, err := client.ListUserMemberships(context.Background(), yourEmail).Execute()
+	getMembershipsResp, err := client.DefaultAPI.ListUserMemberships(context.Background(), yourEmail).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Error when calling `ListUserMemberships`: %v\n", err)
 	} else {
-		userMemberships := *getMembershipsResp.Items
+		userMemberships := getMembershipsResp.Items
 		fmt.Printf("Number of memberships: %v\n", len(userMemberships))
 
 		if len(userMemberships) > 0 {
 			fmt.Printf("Example of a membership of user %s: \nResource type - %s\nResource id - %s\nRole - %s\n",
-				*userMemberships[0].Subject,
-				*userMemberships[0].ResourceType,
-				*userMemberships[0].ResourceId,
-				*userMemberships[0].Role,
+				userMemberships[0].Subject,
+				userMemberships[0].ResourceType,
+				userMemberships[0].ResourceId,
+				userMemberships[0].Role,
 			)
 		}
 	}
 
 	// Get the members of your project
-	getMembersResp, err := client.ListMembers(context.Background(), "project", projectId).Execute()
+	getMembersResp, err := client.DefaultAPI.ListMembers(context.Background(), "project", projectId).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Error when calling `GetMembers`: %v\n", err)
 	} else {
-		fmt.Printf("Number of members: %v\n", len(*getMembersResp.Members))
+		fmt.Printf("Number of members: %v\n", len(getMembersResp.Members))
 	}
 
 	// Add a member to your project or add an additional role to an existing member
 	updateMemberPayload := authorization.AddMembersPayload{
-		Members: &[]authorization.Member{
+		Members: []authorization.Member{
 			{
-				Role:    utils.Ptr("project.member"),
-				Subject: utils.Ptr(emailToBeAdded),
+				Role:    "project.member",
+				Subject: emailToBeAdded,
 			},
 		},
-		ResourceType: utils.Ptr("project"),
+		ResourceType: "project",
 	}
-	_, err = client.AddMembers(context.Background(), projectId).AddMembersPayload(updateMemberPayload).Execute()
+	_, err = client.DefaultAPI.AddMembers(context.Background(), projectId).AddMembersPayload(updateMemberPayload).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Error when calling `UpdateMembers`: %v\n", err)
 	} else {
@@ -77,15 +76,15 @@ func main() {
 
 	// Remove a role from a member of your project
 	deleteMemberPayload := authorization.RemoveMembersPayload{
-		Members: &[]authorization.Member{
+		Members: []authorization.Member{
 			{
-				Role:    utils.Ptr("project.member"),
-				Subject: utils.Ptr(emailToBeAdded),
+				Role:    "project.member",
+				Subject: emailToBeAdded,
 			},
 		},
-		ResourceType: utils.Ptr("project"),
+		ResourceType: "project",
 	}
-	_, err = client.RemoveMembers(context.Background(), projectId).RemoveMembersPayload(deleteMemberPayload).Execute()
+	_, err = client.DefaultAPI.RemoveMembers(context.Background(), projectId).RemoveMembersPayload(deleteMemberPayload).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Error when calling `DeleteMembers`: %v\n", err)
 	} else {

examples/authorization/go.mod

@@ -2,12 +2,13 @@ module github.com/stackitcloud/stackit-sdk-go/examples/authorization
 
 go 1.21
 
-require (
-	github.com/stackitcloud/stackit-sdk-go/core v0.21.1
-	github.com/stackitcloud/stackit-sdk-go/services/authorization v0.12.0
-)
+// This is not needed in production. This is only here to point the golangci linter to the local version instead of the last release on GitHub.
+replace github.com/stackitcloud/stackit-sdk-go/services/authorization => ../../services/authorization
+
+require github.com/stackitcloud/stackit-sdk-go/services/authorization v0.12.0
 
 require (
 	github.com/golang-jwt/jwt/v5 v5.3.1 // indirect
 	github.com/google/uuid v1.6.0 // indirect
+	github.com/stackitcloud/stackit-sdk-go/core v0.22.0 // indirect
 )

examples/authorization/go.sum

@@ -4,7 +4,5 @@ github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
 github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
-github.com/stackitcloud/stackit-sdk-go/core v0.21.1 h1:Y/PcAgM7DPYMNqum0MLv4n1mF9ieuevzcCIZYQfm3Ts=
-github.com/stackitcloud/stackit-sdk-go/core v0.21.1/go.mod h1:osMglDby4csGZ5sIfhNyYq1bS1TxIdPY88+skE/kkmI=
-github.com/stackitcloud/stackit-sdk-go/services/authorization v0.12.0 h1:HxPgBu04j5tj6nfZ2r0l6v4VXC0/tYOGe4sA5Addra8=
-github.com/stackitcloud/stackit-sdk-go/services/authorization v0.12.0/go.mod h1:uYI9pHAA2g84jJN25ejFUxa0/JtfpPZqMDkctQ1BzJk=
+github.com/stackitcloud/stackit-sdk-go/core v0.22.0 h1:6rViz7GnNwXSh51Lur5xuDzO8EWSZfN9J0HvEkBKq6c=
+github.com/stackitcloud/stackit-sdk-go/core v0.22.0/go.mod h1:osMglDby4csGZ5sIfhNyYq1bS1TxIdPY88+skE/kkmI=

services/authorization/CHANGELOG.md

@@ -1,3 +1,9 @@
+## v0.13.0
+- **Feature:** Introduction of multi API version support for the authorization SDK module. For more details please see the announcement on GitHub: https://github.com/stackitcloud/stackit-sdk-go/discussions/5062
+- `v2api`: New package which should be used for communication with the STACKIT authorization API in the future
+- **Deprecation:** The contents in the root of this SDK module including the `wait` package are marked as deprecated and will be removed after 2026-09-30. Switch to the new `v2api` package instead.
+- **Dependencies:** Bump STACKIT SDK core module from `v0.21.1` to `v0.22.0`
+
 ## v0.12.0
 - **Breaking change:** removed operation `GetAssignableSubjects` and related models `AssignableSubject`, `ListAssignableSubjectsResponse`
 

services/authorization/VERSION

@@ -1 +1 @@
-v0.12.0
+v0.13.0