v1

latestSwagger 2.02026-07-178567199.3 KB
sources
users
roles

Create new role for this data source

post/sources/{id}/roles

Path parameters

idstring required

ID of the data source

Request body

namestring required

Unique name of the role

Example request

{
  "users": [
    {
      "name": "admin",
      "links": {
        "self": "/chronograf/v1/sources/3/users/admin"
      }
    }
  ],
  "name": "timetravelers",
  "permissions": [
    {
      "scope": "database",
      "name": "telegraf",
      "allowed": [
        "ReadData",
        "WriteData"
      ]
    }
  ],
  "links": {
    "self": "/chronograf/v1/sources/3/roles/timetravelers"
  }
}

Response

Role successfully created

namestring required

Unique name of the role

Example response

{
  "users": [
    {
      "name": "admin",
      "links": {
        "self": "/chronograf/v1/sources/3/users/admin"
      }
    }
  ],
  "name": "timetravelers",
  "permissions": [
    {
      "scope": "database",
      "name": "telegraf",
      "allowed": [
        "ReadData",
        "WriteData"
      ]
    }
  ],
  "links": {
    "self": "/chronograf/v1/sources/3/roles/timetravelers"
  }
}