summaryrefslogtreecommitdiff
path: root/doc/api/personal_access_tokens.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/api/personal_access_tokens.md')
-rw-r--r--doc/api/personal_access_tokens.md24
1 files changed, 9 insertions, 15 deletions
diff --git a/doc/api/personal_access_tokens.md b/doc/api/personal_access_tokens.md
index 81e6f10f0c6..ea156d92dc8 100644
--- a/doc/api/personal_access_tokens.md
+++ b/doc/api/personal_access_tokens.md
@@ -2,11 +2,19 @@
## List
+This function takes pagination parameters `page` and `per_page` to restrict the list of personal access tokens.
+
```
GET /personal_access_tokens
```
-An example:
+Parameters:
+
+| Attribute | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `state` | string | no | filter tokens based on state (all, active, inactive) |
+
+Example response:
```json
[
{
@@ -20,20 +28,6 @@ An example:
]
```
-In addition, you can filter tokens based on state: `all`, `active` and `inactive`
-
-```
-GET /personal_access_tokens?state=all
-```
-
-```
-GET /personal_access_tokens?state=active
-```
-
-```
-GET /personal_access_tokens?state=inactive
-```
-
## Show
```