Skip to content
You're viewing documentation for v2026.11.5-beta. It may be out of date.Go to latest
TimescaleDB Enterprise
Esc
↑↓navigate↵open⌘Jpreview

List the users

The local users and the OIDC users. The first SSO login of an OIDC user adds it.

GET/api/v1/users
Authorization
tse_sessionAPI key · cookierequired
Responses
200

OK

Array of UserResponse
created_atstring<date-time>required
disabledbooleanrequired
display_namestringrequired
idstringrequired
last_login_atstring<date-time>
must_change_passwordbooleanrequired
rolestringrequired

The default role. none: the user sees only the database services of the grants

Allowed:nonevieweroperatoradmin
service_grantsAuthMeServiceGrant[]required

The roles of the user on single database services

Show properties
Array of AuthMeServiceGrant
rolestringrequired
Allowed:vieweroperator
service_idstringrequired
sourcestringrequired

local: a username and a password. oidc: a user of the identity provider. The first SSO login adds the user, and each login sets the role from the claims

Allowed:localoidc
two_factorbooleanrequired

The user has confirmed TOTP two-factor authentication

updated_atstring<date-time>required
usernamestringrequired
default

Error

codestring

Stable code of the refusal, when the route has codes

detailsstring[]

Additional detail, e.g. per-field validation failures

errorstringrequired

Human-readable error message

Request
curl -X GET 'https://console.example.com/api/v1/users' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
[
  {
    "created_at": "2019-08-24T14:15:22Z",
    "disabled": true,
    "display_name": "string",
    "id": "string",
    "last_login_at": "2019-08-24T14:15:22Z",
    "must_change_password": true,
    "role": "none",
    "service_grants": [
      {
        "role": "viewer",
        "service_id": "string"
      }
    ],
    "source": "local",
    "two_factor": true,
    "updated_at": "2019-08-24T14:15:22Z",
    "username": "string"
  }
]