Introduce User Sharing API v2

components/org.wso2.carbon.identity.api.server.organization.user.sharing.management/org.wso2.carbon.identity.api.server.organization.user.sharing.management.common/src/main/java/org/wso2/carbon/identity/api/server/organization/user/sharing/management/common/UserSharingMgtServiceHolder.java

@@ -20,6 +20,7 @@
 
 import org.wso2.carbon.context.PrivilegedCarbonContext;
 import org.wso2.carbon.identity.organization.management.organization.user.sharing.UserSharingPolicyHandlerService;
+import org.wso2.carbon.identity.organization.management.organization.user.sharing.UserSharingPolicyHandlerServiceV2;
 
 /**
  * Holds the services which the shared user sharing management API component is using.
@@ -35,7 +36,14 @@ private static class UserSharingPolicyHandlerServiceHolder {
         private static final UserSharingPolicyHandlerService SERVICE = (UserSharingPolicyHandlerService)
                 PrivilegedCarbonContext.getThreadLocalCarbonContext()
                         .getOSGiService(UserSharingPolicyHandlerService.class, null);
-        }
+    }
+
+    private static class UserSharingPolicyHandlerServiceV2Holder {
+
+        private static final UserSharingPolicyHandlerServiceV2 SERVICE =
+                (UserSharingPolicyHandlerServiceV2) PrivilegedCarbonContext.getThreadLocalCarbonContext()
+                        .getOSGiService(UserSharingPolicyHandlerServiceV2.class, null);
+    }
 
     /**
      * Get UserSharingPolicyHandlerService service.
@@ -46,4 +54,14 @@ public static UserSharingPolicyHandlerService getUserSharingPolicyHandlerService
 
         return UserSharingMgtServiceHolder.UserSharingPolicyHandlerServiceHolder.SERVICE;
     }
+
+    /**
+     * Get UserSharingPolicyHandlerServiceV2 service.
+     *
+     * @return UserSharingPolicyHandlerServiceV2.
+     */
+    public static UserSharingPolicyHandlerServiceV2 getUserSharingPolicyHandlerServiceV2() {
+
+        return UserSharingMgtServiceHolder.UserSharingPolicyHandlerServiceV2Holder.SERVICE;
+    }
 }

components/org.wso2.carbon.identity.api.server.organization.user.sharing.management/org.wso2.carbon.identity.api.server.organization.user.sharing.management.common/src/main/java/org/wso2/carbon/identity/api/server/organization/user/sharing/management/common/constants/UserSharingMgtConstants.java

@@ -30,6 +30,8 @@ public class UserSharingMgtConstants {
     public static final String RESPONSE_STATUS_PROCESSING = "Processing";
     public static final String RESPONSE_DETAIL_USER_SHARE = "User sharing process triggered successfully.";
     public static final String RESPONSE_DETAIL_USER_UNSHARE = "User unsharing process triggered successfully.";
+    public static final String RESPONSE_DETAIL_USER_SHARE_PATCH =
+            "Shared user attributes patch process triggered successfully.";
 
     /**
      * Enum for user sharing management related errors.
@@ -60,6 +62,33 @@ public enum ErrorMessage {
                 "Invalid UUID format.",
                 "The UUID provided in the request is not in a valid format. " +
                         "Please provide a valid UUID."),
+        INVALID_USER_SHARE_PATCH_REQUEST_BODY("60005",
+                "Invalid user share patch request body.",
+                "The user share patch request body is either null or empty. " +
+                        "Please provide a valid user share patch request body."),
+        ERROR_MISSING_USER_CRITERIA("60006",
+                "Missing user criteria in the request body.",
+                "The user criteria is missing in the request body. Please provide the user criteria to proceed."),
+        ERROR_UNSUPPORTED_USER_SHARE_PATCH_PATH("60007",
+                "Unsupported user share patch path.",
+                "The provided patch path to update attributes of shared user is not supported. " +
+                        "Please provide a valid patch path."),
+        ERROR_EMPTY_USER_SHARE_PATCH_PATH("60008",
+                "Empty user share patch path.",
+                "The provided patch path to update attributes of shared user is empty. " +
+                        "Please provide a valid patch path."),
+        ERROR_UNSUPPORTED_USER_SHARE_POLICY("60009",
+                "Unsupported user share policy.",
+                "The provided user share policy is not supported. Please provide a valid user share policy."),
+        ERROR_MISSING_USER_IDS("60010",
+                "Missing user ID(s) in the request body.",
+                "The user ID(s) is missing in the request body. Please provide the user ID to proceed."),
+        ERROR_INVALID_LIMIT("60011",
+                "Invalid limit value.",
+                "The limit value provided in the request is invalid. Please provide a valid limit value."),
+        ERROR_INVALID_CURSOR("60012",
+                "Invalid cursor value.",
+                "The cursor value provided in the request is invalid. Please provide a valid cursor value."),
 
         // Server errors.
         ERROR_INITIATING_USERS_API_SERVICE("65001",

components/org.wso2.carbon.identity.api.server.organization.user.sharing.management/org.wso2.carbon.identity.api.server.organization.user.sharing.management.v2/pom.xml

@@ -0,0 +1,173 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Copyright (c) 2025, WSO2 LLC. (http://www.wso2.com).
+  ~
+  ~ WSO2 LLC. licenses this file to you under the Apache License,
+  ~ Version 2.0 (the "License"); you may not use this file except
+  ~ in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~ http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing,
+  ~ software distributed under the License is distributed on an
+  ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  ~ KIND, either express or implied.  See the License for the
+  ~ specific language governing permissions and limitations
+  ~ under the License.
+  -->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.wso2.carbon.identity.server.api</groupId>
+        <artifactId>org.wso2.carbon.identity.api.server.organization.user.sharing.management</artifactId>
+        <version>1.3.231-SNAPSHOT</version>
+        <relativePath>../pom.xml</relativePath>
+    </parent>
+
+    <artifactId>org.wso2.carbon.identity.api.server.organization.user.sharing.management.v2</artifactId>
+    <packaging>jar</packaging>
+
+    <dependencies>
+        <dependency>
+            <groupId>javax.ws.rs</groupId>
+            <artifactId>javax.ws.rs-api</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.jaxrs</groupId>
+            <artifactId>jackson-jaxrs-json-provider</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.cxf</groupId>
+            <artifactId>cxf-rt-frontend-jaxrs</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.cxf</groupId>
+            <artifactId>cxf-rt-rs-service-description</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger</groupId>
+            <artifactId>swagger-jaxrs</artifactId>
+            <exclusions>
+                <exclusion>
+                    <groupId>com.fasterxml.jackson.core</groupId>
+                    <artifactId>jackson-databind</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>com.fasterxml.jackson.core</groupId>
+                    <artifactId>jackson-annotations</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>com.fasterxml.jackson.core</groupId>
+                    <artifactId>jackson-core</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>com.fasterxml.jackson.dataformat</groupId>
+                    <artifactId>jackson-dataformat-yaml</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>javax.ws.rs</groupId>
+                    <artifactId>jsr311-api</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>com.google.guava</groupId>
+                    <artifactId>guava</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.wso2.carbon.identity.server.api</groupId>
+            <artifactId>org.wso2.carbon.identity.api.server.organization.user.sharing.management.common</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.wso2.carbon.identity.server.api</groupId>
+            <artifactId>org.wso2.carbon.identity.api.server.common</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.wso2.carbon.identity.organization.management</groupId>
+            <artifactId>org.wso2.carbon.identity.organization.management.organization.user.sharing</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.wso2.carbon.identity.organization.management</groupId>
+            <artifactId>org.wso2.carbon.identity.organization.resource.sharing.policy.management</artifactId>
+            <scope>provided</scope>
+        </dependency>
+    </dependencies>
+    <build>
+        <plugins>
+            <!--<plugin>
+                <groupId>org.openapitools</groupId>
+                <artifactId>openapi-generator-maven-plugin</artifactId>
+                <version>4.1.2</version>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>generate</goal>
+                        </goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/organization-user-share-v2.yaml</inputSpec>
+                            <generatorName>org.wso2.carbon.codegen.CxfWso2Generator</generatorName>
+                            <configOptions>
+                                <sourceFolder>src/gen/java</sourceFolder>
+                                <apiPackage>org.wso2.carbon.identity.api.server.organization.user.sharing.management.v2</apiPackage>
+                                <modelPackage>org.wso2.carbon.identity.api.server.organization.user.sharing.management.v2.model</modelPackage>
+                                <packageName>org.wso2.carbon.identity.api.server.organization.user.sharing.management.v2</packageName>
+                                <dateLibrary>java8</dateLibrary>
+                                <hideGenerationTimestamp>true</hideGenerationTimestamp>
+                            </configOptions>
+                            <output>.</output>
+                            <skipOverwrite>false</skipOverwrite>
+                        </configuration>
+                    </execution>
+                </executions>
+                <dependencies>
+                    <dependency>
+                        <groupId>org.openapitools</groupId>
+                        <artifactId>cxf-wso2-openapi-generator</artifactId>
+                        <version>1.0.0</version>
+                    </dependency>
+                </dependencies>
+            </plugin>-->
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>build-helper-maven-plugin</artifactId>
+                <version>1.8</version>
+                <executions>
+                    <execution>
+                        <id>add-source</id>
+                        <phase>generate-sources</phase>
+                        <goals>
+                            <goal>add-source</goal>
+                        </goals>
+                        <configuration>
+                            <sources>
+                                <source>src/gen/java</source>
+                            </sources>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>${maven.compiler.plugin.version}</version>
+                <configuration>
+                    <source>1.8</source>
+                    <target>1.8</target>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+</project>