From 2bb16fac18a6a91847201c174f3bf1208338f6aa Mon Sep 17 00:00:00 2001
From: Max Wittig <max.wittig@siemens.com>
Date: Wed, 17 Feb 2021 15:54:09 +0100
Subject: feat: add personal access token API

See: https://docs.gitlab.com/ee/api/personal_access_tokens.html
---
 docs/gl_objects/personal_access_tokens.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 docs/gl_objects/personal_access_tokens.rst

(limited to 'docs')

diff --git a/docs/gl_objects/personal_access_tokens.rst b/docs/gl_objects/personal_access_tokens.rst
new file mode 100644
index 0000000..3cbc744
--- /dev/null
+++ b/docs/gl_objects/personal_access_tokens.rst
@@ -0,0 +1,28 @@
+######################
+Personal Access Tokens
+######################
+
+Get a list of personal access tokens
+
+References
+----------
+
+* v4 API:
+
+  + :class:`gitlab.v4.objects.PersonalAccessToken`
+  + :class:`gitlab.v4.objects.PersonalAcessTokenManager`
+  + :attr:`gitlab.Gitlab.personal_access_tokens`
+
+* GitLab API: https://docs.gitlab.com/ee/api/personal_access_tokens.html
+
+Examples
+--------
+
+List personal access tokens::
+
+    access_tokens = gl.personal_access_tokens.list()
+    print(access_tokens[0].name)
+
+List personal access tokens from other user_id (admin only)::
+
+    access_tokens = gl.personal_access_tokens.list(user_id=25)
-- 
cgit v1.2.1