v1

latestOpenAPI 3.1.02026-07-174237122.7 KB
v1
auth

auth token

Controller:

github.com/ubccr/grendel/internal/api.(*Handler).AuthToken

Middlewares:

  • github.com/go-fuego/fuego.defaultLogger.middleware
  • github.com/ubccr/grendel/internal/api.(*Handler).authMiddleware

Create API token

post/v1/auth/token

Headers

Acceptstring

Request body

expirestring

string parsed by time.ParseDuration, examples include: infinite, 8h, 30m, 20s

rolestring

type of model.Role, valid options: disabled, user, admin

usernamestring

username shown in logs, does not need to be a valid user in the DB

Example request

{
  "expire": "infinite",
  "role": "admin",
  "username": "user1:CLI"
}

Response

OK

tokenstring