diff --git a/src/main/java/org/gitlab4j/api/PersonalAccessTokenApi.java b/src/main/java/org/gitlab4j/api/PersonalAccessTokenApi.java index 2b77cc40..4f92004d 100644 --- a/src/main/java/org/gitlab4j/api/PersonalAccessTokenApi.java +++ b/src/main/java/org/gitlab4j/api/PersonalAccessTokenApi.java @@ -93,4 +93,20 @@ public PersonalAccessToken getPersonalAccessToken(String id) throws GitLabApiExc Response response = get(Response.Status.OK, null, "personal_access_tokens", id); return (response.readEntity(PersonalAccessToken.class)); } + + /** + * Revokes a personal access token. Available only for admin users. + * + *
GitLab Endpoint: DELETE /personal_access_tokens/:token_id
+ * @param tokenId the personal access token ID to revoke
+ * @throws GitLabApiException if any exception occurs
+ */
+ public void revokePersonalAccessToken(Long tokenId) throws GitLabApiException {
+ if (tokenId == null) {
+ throw new RuntimeException("tokenId cannot be null");
+ }
+ Response.Status expectedStatus =
+ (isApiVersion(GitLabApi.ApiVersion.V3) ? Response.Status.OK : Response.Status.NO_CONTENT);
+ delete(expectedStatus, null, "personal_access_tokens", tokenId);
+ }
}
diff --git a/src/main/java/org/gitlab4j/api/UserApi.java b/src/main/java/org/gitlab4j/api/UserApi.java
index c9551413..4256a90c 100644
--- a/src/main/java/org/gitlab4j/api/UserApi.java
+++ b/src/main/java/org/gitlab4j/api/UserApi.java
@@ -786,9 +786,30 @@ public OptionalGitLab Endpoint: POST /user/keys
+ *
+ * @param title the new SSH Key's title
+ * @param key the new SSH key
+ * @param expiresAt the expiration date of the ssh key, optional
+ * @return an SshKey instance with info on the added SSH key
+ * @throws GitLabApiException if any exception occurs
+ */
+ public SshKey addSshKey(String title, String key, Date expiresAt) throws GitLabApiException {
+ GitLabApiForm formData = new GitLabApiForm()
+ .withParam("title", title)
+ .withParam("key", key)
+ .withParam("expires_at", expiresAt);
+
Response response = post(Response.Status.CREATED, formData, "user", "keys");
return (response.readEntity(SshKey.class));
}
@@ -803,20 +824,40 @@ public SshKey addSshKey(String title, String key) throws GitLabApiException {
* @param key the new SSH key
* @return an SshKey instance with info on the added SSH key
* @throws GitLabApiException if any exception occurs
+ * @deprecated use {@link #addSshKey(Long, String, String, Date)} instead
*/
+ @Deprecated
public SshKey addSshKey(Long userId, String title, String key) throws GitLabApiException {
+ return addSshKey(userId, title, key, null);
+ }
+ /**
+ * Create new key owned by specified user. Available only for admin users.
+ *
+ * GitLab Endpoint: POST /users/:id/keys
+ *
+ * @param userId the ID of the user to add the SSH key for
+ * @param title the new SSH Key's title
+ * @param key the new SSH key
+ * @param expiresAt the expiration date of the ssh key, optional
+ * @return an SshKey instance with info on the added SSH key
+ * @throws GitLabApiException if any exception occurs
+ */
+ public SshKey addSshKey(Long userId, String title, String key, Date expiresAt) throws GitLabApiException {
if (userId == null) {
throw new RuntimeException("userId cannot be null");
}
- GitLabApiForm formData = new GitLabApiForm().withParam("title", title).withParam("key", key);
+ GitLabApiForm formData = new GitLabApiForm()
+ .withParam("title", title)
+ .withParam("key", key)
+ .withParam("expires_at", expiresAt);
+
Response response = post(Response.Status.CREATED, formData, "users", userId, "keys");
SshKey sshKey = response.readEntity(SshKey.class);
if (sshKey != null) {
sshKey.setUserId(userId);
}
-
return (sshKey);
}
@@ -993,6 +1034,23 @@ public ImpersonationToken createPersonalAccessToken(
return createPersonalAccessTokenOrImpersonationToken(userIdOrUsername, name, expiresAt, scopes, false);
}
+ /**
+ * Revokes a personal access token. Available only for admin users.
+ *
+ * GitLab Endpoint: DELETE /personal_access_tokens/:token_id
+ * @param tokenId the personal access token ID to revoke
+ * @throws GitLabApiException if any exception occurs
+ */
+ public void revokePersonalAccessToken(Long tokenId) throws GitLabApiException {
+ if (tokenId == null) {
+ throw new RuntimeException("tokenId cannot be null");
+ }
+
+ Response.Status expectedStatus =
+ (isApiVersion(ApiVersion.V3) ? Response.Status.OK : Response.Status.NO_CONTENT);
+ delete(expectedStatus, null, "personal_access_tokens", tokenId);
+ }
+
// as per https://docs.gitlab.com/ee/api/README.html#impersonation-tokens, impersonation tokens are a type of
// personal access token
private ImpersonationToken createPersonalAccessTokenOrImpersonationToken(