Sign in

v1

latestSwagger 2.02026-07-178567199.3 KB
organizations
users

Create new user

Creates a Chronograf user in the store

post/users

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 created

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
}