POST /api/usergroups
Create a user group

Examples

POST /api/usergroups
{
  "usergroup": {
    "name": "test_usergroup",
    "role_ids": [
      1,
      3,
      4
    ]
  }
}
201
{
  "admin": false,
  "created_at": "2022-03-29 08:50:12 UTC",
  "updated_at": "2022-03-29 08:50:12 UTC",
  "name": "test_usergroup",
  "id": 4,
  "external_usergroups": [],
  "usergroups": [],
  "users": [],
  "roles": [
    {
      "name": "Manager",
      "id": 1,
      "description": null,
      "origin": "foreman"
    },
    {
      "name": "View hosts",
      "id": 3,
      "description": null,
      "origin": "foreman"
    },
    {
      "name": "Edit hosts",
      "id": 4,
      "description": null,
      "origin": "foreman"
    }
  ]
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer
usergroup
required

Validations:

  • Must be a Hash
usergroup[name]
required

Validations:

  • Must be a String
usergroup[admin]
optional , nil allowed

is an admin user group, can be modified by admins only

Validations:

  • Must be one of: true, false, 1, 0.
usergroup[user_ids]
optional , nil allowed

Validations:

  • Must be an array of any type
usergroup[usergroup_ids]
optional , nil allowed

Validations:

  • Must be an array of any type
usergroup[role_ids]
optional , nil allowed

Validations:

  • Must be an array of any type