• 列出个人访问令牌
• 获取单个个人访问令牌
  • 使用个人访问令牌 ID
    • 响应
  • 使用请求 header
• 轮换个人访问令牌
  • 响应
• 撤回个人访问令牌
  • 使用个人访问令牌 ID
    • 响应
  • 使用请求 Header
    • 响应
• 创建个人访问令牌（仅限管理员）

个人访问令牌 API

您可以阅读更多有关个人访问令牌的内容。

列出个人访问令牌

• 引入于极狐GitLab 13.3。
• 从极狐GitLab 旗舰版移动到免费版于 13.6。
• created_after、created_before、last_used_after、last_used_before、revoked、search 和 state 引入于极狐GitLab 15.5。

获取经过身份验证的用户有权访问的所有个人访问令牌。默认情况下，返回一个未过滤的列表：

• 只有当前用户创建的非管理员个人访问令牌。
• 管理员的所有个人访问令牌。

管理员：

• 可以使用 user_id 参数按用户过滤。
• 可以在所有个人访问令牌上使用其他过滤器（极狐GitLab 15.5 及更高版本）。

非管理员：

• 不能使用 user_id 参数过滤除他们自己以外的任何用户，否则他们会收到 401 Unauthorized 响应。
• 只能在他们自己的个人访问令牌上过滤（极狐GitLab 15.5 及更高版本）。

GET /personal_access_tokens
GET /personal_access_tokens?created_after=2022-01-01T00:00:00
GET /personal_access_tokens?created_before=2022-01-01T00:00:00
GET /personal_access_tokens?last_used_after=2022-01-01T00:00:00
GET /personal_access_tokens?last_used_before=2022-01-01T00:00:00
GET /personal_access_tokens?revoked=true
GET /personal_access_tokens?search=name
GET /personal_access_tokens?state=inactive
GET /personal_access_tokens?user_id=1

支持的参数：

请求示例：

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens"

响应示例：

[
    {
        "id": 4,
        "name": "Test Token",
        "revoked": false,
        "created_at": "2020-07-23T14:31:47.729Z",
        "scopes": [
            "api"
        ],
        "user_id": 24,
        "last_used_at": "2021-10-06T17:58:37.550Z",
        "active": true,
        "expires_at": null
    }
]

请求示例：

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens?user_id=3"

响应示例：

[
    {
        "id": 4,
        "name": "Test Token",
        "revoked": false,
        "created_at": "2020-07-23T14:31:47.729Z",
        "scopes": [
            "api"
        ],
        "user_id": 3,
        "last_used_at": "2021-10-06T17:58:37.550Z",
        "active": true,
        "expires_at": null
    }
]

请求示例：

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens?revoked=true"

响应示例：

[
    {
        "id": 41,
        "name": "Revoked Test Token",
        "revoked": true,
        "created_at": "2022-01-01T14:31:47.729Z",
        "scopes": [
            "api"
        ],
        "user_id": 8,
        "last_used_at": "2022-05-18T17:58:37.550Z",
        "active": false,
        "expires_at": null
    }
]

您可以通过合并的属性进行过滤：

GET /personal_access_tokens?revoked=true&created_before=2022-01-01

获取单个个人访问令牌

使用以下任意一个方法获取个人访问令牌：

• 使用个人访问令牌的 ID
• 将其传递给 header 中的 API

使用个人访问令牌 ID

引入于极狐GitLab 15.1。

通过 ID 获取单个个人访问令牌。用户可以获得自己的令牌。 管理员可以获得任何令牌。

GET /personal_access_tokens/:id

curl --request GET --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens/<id>"

响应

404 HTTP 状态码引入于极狐GitLab 15.3。

• 401: Unauthorized 如果是：
  • 用户无权访问具有指定 ID 的令牌。
  • 具有指定 ID 的令牌不存在。
• 404: Not Found 如果用户是管理员但具有指定 ID 的令牌不存在。

使用请求 header

引入于极狐GitLab 15.5。

通过在 header 中传递令牌来获取单个个人访问令牌和令牌信息。

GET /personal_access_tokens/self

curl --request GET --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens/self"

响应示例：

{
    "id": 4,
    "name": "Test Token",
    "revoked": false,
    "created_at": "2020-07-23T14:31:47.729Z",
    "scopes": [
        "api"
    ],
    "user_id": 3,
    "last_used_at": "2021-10-06T17:58:37.550Z",
    "active": true,
    "expires_at": null
}

轮换个人访问令牌

引入于极狐GitLab 16.0。

轮换个人访问令牌。撤销先前的令牌并创建一个在一周后过期的新令牌。

POST /personal_access_tokens/:id/rotate

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens/<personal_access_token_id>/rotate"

响应

• 200: OK：如果现有令牌已成功撤销并且新令牌已成功创建。
• 400: Bad Request：如果没有成功轮换。
• 401: Unauthorized：如果出现以下任一情况：
  • 用户无权访问具有指定 ID 的令牌。
  • 具有指定 ID 的令牌不存在。
• 404: Not Found：如果用户是管理员但具有指定 ID 的令牌不存在。

撤回个人访问令牌

可以使用以下内容之一撤回个人访问令牌：

• 使用个人访问令牌的 ID
• 将其传递到 Header 中的 API

使用个人访问令牌 ID

• 引入于极狐GitLab 13.3。
• 从极狐GitLab 旗舰版移动到免费版于 13.6。

使用 ID 撤回个人访问令牌。

DELETE /personal_access_tokens/:id

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens/<personal_access_token_id>"

响应

• 撤回成功：204: No Content
• 撤回失败：400: Bad Request

使用请求 Header

• 引入于极狐GitLab 15.0。限定为带有 api 范围的令牌。
• 引入于极狐GitLab 15.4，任何令牌都可以使用该端点。

撤销使用请求 header 传入的个人访问令牌。要求：

• 15.0 到 15.3 中为 api 范围
• 15.4 及更高版本中为任何范围

DELETE /personal_access_tokens/self

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens/self"

响应

• 撤回成功：204: No Content
• 撤回失败：400: Bad Request

创建个人访问令牌（仅限管理员）

有关创建个人访问令牌的内容，请参见用户 API 文档。