v1

latestSwagger 2.02026-07-178567199.3 KB

organizations

users

Update existing user

Updates a Chronograf user in the store

patch/users/{id}

Path parameters

idstring required

ID of the user

Request body

idstring required

Unique identifier representing a user resource

namestring required

Username (as taken from principal given by auth provider)

providerstring required

OAuth provider used to authenticate

schemestring required

Scheme used to authenticate (only OAuth2 currently supported)

superAdminboolean

If user has the ability to perform CRUD operations on Organizations, across Organizations, and on other SuperAdmin users

Example request

{
  "id": "1",
  "links": {
    "self": "/chronograf/v1/users/1"
  },
  "name": "pineapple@cubeoctohedron.flux",
  "provider": "github",
  "roles": {
    "name": "editor",
    "organization": "SpaceTeam"
  },
  "scheme": "oauth2",
  "superAdmin": false
}

Response

User successfully updated

idstring required

Unique identifier representing a user resource

namestring required

Username (as taken from principal given by auth provider)

providerstring required

OAuth provider used to authenticate

schemestring required

Scheme used to authenticate (only OAuth2 currently supported)

superAdminboolean

If user has the ability to perform CRUD operations on Organizations, across Organizations, and on other SuperAdmin users

Example response

{
  "id": "1",
  "links": {
    "self": "/chronograf/v1/users/1"
  },
  "name": "pineapple@cubeoctohedron.flux",
  "provider": "github",
  "roles": {
    "name": "editor",
    "organization": "SpaceTeam"
  },
  "scheme": "oauth2",
  "superAdmin": false
}