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

List a user's grants

List the service grants of a user.

GET/api/v1/users/{id}/service-grants
Authorization
tse_sessionAPI key · cookierequired
Path parameters
idstringrequired
Responses
200

OK

Array of ServiceGrantResponse
created_atstring<date-time>required
created_bystringrequired

The admin who gave the grant, as the audit log shows it

rolestringrequired
Allowed:vieweroperator
service_idstringrequired
service_namestringrequired
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/string/service-grants' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
[
  {
    "created_at": "2019-08-24T14:15:22Z",
    "created_by": "string",
    "role": "viewer",
    "service_id": "string",
    "service_name": "string"
  }
]