summaryrefslogtreecommitdiff
path: root/docs/gl_objects/group_access_tokens.rst
blob: 390494f0b1d243609af886e2a3135f136f9d2daf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
#####################
Group Access Tokens
#####################

Get a list of group access tokens

References
----------

* v4 API:

  + :class:`gitlab.v4.objects.GroupAccessToken`
  + :class:`gitlab.v4.objects.GroupAccessTokenManager`
  + :attr:`gitlab.Gitlab.group_access_tokens`

* GitLab API: https://docs.gitlab.com/ee/api/group_access_tokens.html

Examples
--------

List group access tokens::

    access_tokens = gl.groups.get(1, lazy=True).access_tokens.list()
    print(access_tokens[0].name)

Create group access token::

    access_token = gl.groups.get(1).access_tokens.create({"name": "test", "scopes": ["api"]})

Revoke a group access tokens::

    gl.groups.get(1).access_tokens.delete(42)
    # or
    access_token.delete()