Merge remote-tracking branch 'origin/main' into 6.x

Author: jmini

src/main/java/org/gitlab4j/api/IssuesApi.java

@@ -551,7 +551,7 @@ public Issue updateIssue(Object projectIdOrPath, Long issueIid, String title, St
     }
 
     /**
-     * Updates an existing project issue. This call can also be used to mark an issue as closed.
+     * Updates an existing project issue to change the assignee.
      *
      * <pre><code>GitLab Endpoint: PUT /projects/:id/issues/:issue_iid</code></pre>
      *
@@ -562,12 +562,32 @@ public Issue updateIssue(Object projectIdOrPath, Long issueIid, String title, St
      * @throws GitLabApiException if any exception occurs
      */
     public Issue assignIssue(Object projectIdOrPath, Long issueIid, Long assigneeId) throws GitLabApiException {
+        return assignIssue(projectIdOrPath, issueIid, Collections.singletonList(assigneeId));
+    }
+
+    /**
+     * Updates an existing project issue to change the assignees.
+     *
+     * <pre><code>GitLab Endpoint: PUT /projects/:id/issues/:issue_iid</code></pre>
+     *
+     * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance, required
+     * @param issueIid the issue IID to update, required
+     * @param assigneeIds the IDs of the user to assign issue to, required, use an empty list to clear the assignees
+     * @return an instance of the updated Issue
+     * @throws GitLabApiException if any exception occurs
+     */
+    public Issue assignIssue(Object projectIdOrPath, Long issueIid, List<Long> assigneeIds) throws GitLabApiException {
 
         if (issueIid == null) {
             throw new RuntimeException("issue IID cannot be null");
         }
 
-        GitLabApiForm formData = new GitLabApiForm().withParam("assignee_ids", Collections.singletonList(assigneeId));
+        // replace empty list with an invalid userId (clears the assignees in gitlab)
+        if (assigneeIds.isEmpty()) {
+            assigneeIds = Collections.singletonList(0L);
+        }
+
+        GitLabApiForm formData = new GitLabApiForm().withParam("assignee_ids", assigneeIds);
         Response response = put(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "issues", issueIid);
         return (response.readEntity(Issue.class));
     }