diff options
| author | Nejc Habjan <hab.nejc@gmail.com> | 2021-09-12 20:58:31 +0200 |
|---|---|---|
| committer | Nejc Habjan <hab.nejc@gmail.com> | 2021-09-13 08:55:22 +0200 |
| commit | 4e8e4b4101059eee43c4c012b131355428ebc4f7 (patch) | |
| tree | 17a058762552947a2c79757ed2e31b4a08050386 /docs | |
| parent | ce4bc0daef355e2d877360c6e496c23856138872 (diff) | |
| download | gitlab-feat/create-delete-token.tar.gz | |
feat(objects): support Create and Revoke personal access token APIfeat/create-delete-token
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/gl_objects/personal_access_tokens.rst | 32 |
1 files changed, 29 insertions, 3 deletions
diff --git a/docs/gl_objects/personal_access_tokens.rst b/docs/gl_objects/personal_access_tokens.rst index 3cbc744..0704c75 100644 --- a/docs/gl_objects/personal_access_tokens.rst +++ b/docs/gl_objects/personal_access_tokens.rst @@ -2,8 +2,6 @@ Personal Access Tokens ###################### -Get a list of personal access tokens - References ---------- @@ -12,8 +10,14 @@ References + :class:`gitlab.v4.objects.PersonalAccessToken` + :class:`gitlab.v4.objects.PersonalAcessTokenManager` + :attr:`gitlab.Gitlab.personal_access_tokens` + + :class:`gitlab.v4.objects.UserPersonalAccessToken` + + :class:`gitlab.v4.objects.UserPersonalAcessTokenManager` + + :attr:`gitlab.Gitlab.User.personal_access_tokens` + +* GitLab API: -* GitLab API: https://docs.gitlab.com/ee/api/personal_access_tokens.html + + https://docs.gitlab.com/ee/api/personal_access_tokens.html + + https://docs.gitlab.com/ee/api/users.html#create-a-personal-access-token Examples -------- @@ -26,3 +30,25 @@ List personal access tokens:: List personal access tokens from other user_id (admin only):: access_tokens = gl.personal_access_tokens.list(user_id=25) + +Revoke a personal access token fetched via list:: + + access_token = access_tokens[0] + access_token.delete() + +Revoke a personal access token by id:: + + gl.personal_access_tokens.delete(123) + +Create a personal access token for a user (admin only):: + + user = gl.users.get(25, lazy=True) + access_token = user.personal_access_tokens.create({"name": "test", "scopes": "api"}) + +.. note:: As you can see above, you can only create personal access tokens + via the Users API, but you cannot revoke these objects directly. + This is because the create API uses a different endpoint than the list and revoke APIs. + You need to fetch the token via the list API first to revoke it. + + As of 14.2, GitLab does not provide a GET API for single personal access tokens. + You must use the list method to retrieve single tokens. |