User HTTP resources / actions

Search Users

GET /api/users?perpage=10&page=1

Example Request:

  1. GET /api/users HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Basic YWRtaW46YWRtaW4=

Default value for the perpage parameter is 1000 and for the page parameter is 1. Requires basic authentication and that the authenticated user is a Grafana Admin.

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. [
  5.   {
  6.     "id": 1,
  7.     "name": "Admin",
  8.     "login": "admin",
  9.     "email": "admin@mygraf.com",
  10.     "isAdmin": true
  11.   },
  12.   {
  13.     "id": 2,
  14.     "name": "User",
  15.     "login": "user",
  16.     "email": "user@mygraf.com",
  17.     "isAdmin": false
  18.   }
  19. ]

Search Users with Paging

GET /api/users/search?perpage=10&page=1&query=mygraf

Example Request:

  1. GET /api/users/search?perpage=10&page=1&query=mygraf HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Basic YWRtaW46YWRtaW4=

Default value for the perpage parameter is 1000 and for the page parameter is 1. The totalCount field in the response can be used for pagination of the user list E.g. if totalCount is equal to 100 users and the perpage parameter is set to 10 then there are 10 pages of users. The query parameter is optional and it will return results where the query value is contained in one of the name, login or email fields. Query values with spaces need to be url encoded e.g. query=Jane%20Doe.

Requires basic authentication and that the authenticated user is a Grafana Admin.

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  3. {
  4.   "totalCount": 2,
  5.   "users": [
  6.     {
  7.       "id": 1,
  8.       "name": "Admin",
  9.       "login": "admin",
  10.       "email": "admin@mygraf.com",
  11.       "isAdmin": true
  12.     },
  13.     {
  14.       "id": 2,
  15.       "name": "User",
  16.       "login": "user",
  17.       "email": "user@mygraf.com",
  18.       "isAdmin": false
  19.     }
  20.   ],
  21.   "page": 1,
  22.   "perPage": 10
  23. }

Get single user by Id

GET /api/users/:id

Example Request:

  1. GET /api/users/1 HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Basic YWRtaW46YWRtaW4=

Requires basic authentication and that the authenticated user is a Grafana Admin.

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. {
  5.   "email": "user@mygraf.com"
  6.   "name": "admin",
  7.   "login": "admin",
  8.   "theme": "light",
  9.   "orgId": 1,
  10.   "isGrafanaAdmin": true
  11. }

Get single user by Username(login) or Email

GET /api/users/lookup?loginOrEmail=user@mygraf.com

Example Request using the email as option:

  1. GET /api/users/lookup?loginOrEmail=user@mygraf.com HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Example Request using the username as option:

  1. GET /api/users/lookup?loginOrEmail=admin HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Basic YWRtaW46YWRtaW4=

Requires basic authentication and that the authenticated user is a Grafana Admin.

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. {
  5.   "id": 1,
  6.   "email": "user@mygraf.com",
  7.   "name": "admin",
  8.   "login": "admin",
  9.   "theme": "light",
  10.   "orgId": 1,
  11.   "isGrafanaAdmin": true
  12. }

User Update

PUT /api/users/:id

Example Request:

  1. PUT /api/users/2 HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Basic YWRtaW46YWRtaW4=
  6. {
  7.   "email":"user@mygraf.com",
  8.   "name":"User2",
  9.   "login":"user",
  10.   "theme":"light"
  11. }

Requires basic authentication and that the authenticated user is a Grafana Admin.

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. {"message":"User updated"}

Get Organizations for user

GET /api/users/:id/orgs

Example Request:

  1. GET /api/users/1/orgs HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Basic YWRtaW46YWRtaW4=

Requires basic authentication and that the authenticated user is a Grafana Admin.

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. [
  5.   {
  6.     "orgId":1,
  7.     "name":"Main Org.",
  8.     "role":"Admin"
  9.   }
  10. ]

Get Teams for user

GET /api/users/:id/teams

Example Request:

  1. GET /api/users/1/teams HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Basic YWRtaW46YWRtaW4=

Requires basic authentication and that the authenticated user is a Grafana Admin.

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. [
  5.   {
  6.     "id":1,
  7.     "orgId":1,
  8.     "name":"team1",
  9.     "email":"",
  10.     "avatarUrl":"/avatar/3fcfe295eae3bcb67a49349377428a66",
  11.     "memberCount":1
  12.   }
  13. ]

User

Actual User

GET /api/user

Example Request:

  1. GET /api/user HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. {
  5.   "email":"admin@mygraf.com",
  6.   "name":"Admin",
  7.   "login":"admin",
  8.   "theme":"light",
  9.   "orgId":1,
  10.   "isGrafanaAdmin":true
  11. }

Change Password

PUT /api/user/password

Changes the password for the user

Example Request:

  1. PUT /api/user/password HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
  6. {
  7.   "oldPassword": "old_password",
  8.   "newPassword": "new_password",
  9.   "confirmNew": "confirm_new_password"
  10. }

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. {"message":"User password changed"}

Switch user context for a specified user

POST /api/users/:userId/using/:organizationId

Switch user context to the given organization. Requires basic authentication and that the authenticated user is a Grafana Admin.

Example Request:

  1. POST /api/users/7/using/2 HTTP/1.1
  2. Authorization: Basic YWRtaW46YWRtaW4=

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. {"message":"Active organization changed"}

Switch user context for signed in user

POST /api/user/using/:organizationId

Switch user context to the given organization.

Example Request:

  1. POST /api/user/using/2 HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. {"message":"Active organization changed"}

Organizations of the actual User

GET /api/user/orgs

Return a list of all organizations of the current user.

Example Request:

  1. GET /api/user/orgs HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. [
  5.   {
  6.     "orgId":1,
  7.     "name":"Main Org.",
  8.     "role":"Admin"
  9.   }
  10. ]

Teams that the actual User is member of

GET /api/user/teams

Return a list of all teams that the current user is member of.

Example Request:

  1. GET /api/user/teams HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. [
  5.   {
  6.     "id": 1,
  7.     "orgId": 1,
  8.     "name": "MyTestTeam",
  9.     "email": "",
  10.     "avatarUrl": "\/avatar\/3f49c15916554246daa714b9bd0ee398",
  11.     "memberCount": 1
  12.   }
  13. ]

Star a dashboard

POST /api/user/stars/dashboard/:dashboardId

Stars the given Dashboard for the actual user.

Example Request:

  1. POST /api/user/stars/dashboard/1 HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. {"message":"Dashboard starred!"}

Unstar a dashboard

DELETE /api/user/stars/dashboard/:dashboardId

Deletes the starring of the given Dashboard for the actual user.

Example Request:

  1. DELETE /api/user/stars/dashboard/1 HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. {"message":"Dashboard unstarred"}

Auth tokens of the actual User

GET /api/user/auth-tokens

Return a list of all auth tokens (devices) that the actual user currently have logged in from.

Example Request:

  1. GET /api/user/auth-tokens HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. [
  5.   {
  6.     "id": 361,
  7.     "isActive": true,
  8.     "clientIp": "127.0.0.1",
  9.     "browser": "Chrome",
  10.     "browserVersion": "72.0",
  11.     "os": "Linux",
  12.     "osVersion": "",
  13.     "device": "Other",
  14.     "createdAt": "2019-03-05T21:22:54+01:00",
  15.     "seenAt": "2019-03-06T19:41:06+01:00"
  16.   },
  17.   {
  18.     "id": 364,
  19.     "isActive": false,
  20.     "clientIp": "127.0.0.1",
  21.     "browser": "Mobile Safari",
  22.     "browserVersion": "11.0",
  23.     "os": "iOS",
  24.     "osVersion": "11.0",
  25.     "device": "iPhone",
  26.     "createdAt": "2019-03-06T19:41:19+01:00",
  27.     "seenAt": "2019-03-06T19:41:21+01:00"
  28.   }
  29. ]

Revoke an auth token of the actual User

POST /api/user/revoke-auth-token

Revokes the given auth token (device) for the actual user. User of issued auth token (device) will no longer be logged in and will be required to authenticate again upon next activity.

Example Request:

  1. POST /api/user/revoke-auth-token HTTP/1.1
  2. Accept: application/json
  3. Content-Type: application/json
  4. Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
  6. {
  7.   "authTokenId": 364
  8. }

Example Response:

  1. HTTP/1.1 200
  2. Content-Type: application/json
  4. {
  5.   "message": "User auth token revoked"
  6. }