List personal access tokens
GET
/v2/access-tokens Returns a paginated list of personal access tokens.
Connection and access
API connection and authentication guidance
https://hub.docker.com
—
Docker HUB API
Use one of these alternatives. Requirements within an alternative apply together.
bearerAuth
Parameters
page
query
Page number to return.
Type:
number
All schema constraints and annotations
{
"default": 1,
"type": "number"
}page_size
query
Number of results per page.
Type:
number
All schema constraints and annotations
{
"default": 10,
"type": "number"
}Request and responses
Response
200
OK
application/json
Schema:
getAccessTokensResponse
Schema example
{
"active_count": 1,
"count": 1,
"next": null,
"previous": null,
"results": [
{
"client_id": "HUB",
"created_at": "2021-07-20T12:00:00.000000Z",
"creator_ip": "127.0.0.1",
"creator_ua": "some user agent",
"expires_at": "2021-10-28T18:30:19.520861Z",
"generated_by": "manual",
"is_active": true,
"last_used": null,
"scopes": [
"repo:read"
],
"token": "***",
"token_label": "My read only token",
"uuid": "b30bbf97-506c-4ecd-aabc-842f3cb484fb"
}
]
}Response
400
Bad Request
application/json
Schema:
error
error
{
"errinfo": null,
"message": "bad request"
}Response
401
Unauthorized
application/json
Schema:
error
error
{
"errinfo": null,
"message": "unauthorized"
}Referenced schemas
#/components/schemas/getAccessTokensResponse
Complete operation contract
{
"description": "Returns a paginated list of personal access tokens.",
"operationId": "getV2AccessTokens",
"parameters": [
{
"description": "Page number to return.",
"in": "query",
"name": "page",
"schema": {
"default": 1,
"type": "number"
}
},
{
"description": "Number of results per page.",
"in": "query",
"name": "page_size",
"schema": {
"default": 10,
"type": "number"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/getAccessTokensResponse"
}
}
},
"description": "OK"
},
"400": {
"$ref": "#/components/responses/BadRequest"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
}
},
"security": [
{
"bearerAuth": []
}
],
"summary": "List personal access tokens",
"tags": [
"access-tokens"
]
}