v13

latestOpenAPI 3.0.0zlibraw.githubusercontent.com2026-08-01265409652.5 KB
users

Generate an API key for a user

Generates an API key for a user. Only the calling user can generate a token for themselves. Password is required only for internal authentication. Access policy: restricted

post/users/{id}/tokens

Path parameters

idinteger required

User identifier

Request body

descriptionstring required
passwordstring required

Example request

{
  "description": "github-api-key",
  "password": "password"
}

Response

Success

rawAPIKeystring

Example response

{
  "apiKey": {
    "description": "portainer-api-key",
    "id": 1,
    "userId": 1
  }
}