GET /api/roles/:id
Show a role

Examples

GET /api/roles/1-Manager
200
{
  "builtin": 0,
  "cloned_from_id": null,
  "name": "Manager",
  "id": 1,
  "description": null,
  "origin": "foreman",
  "filters": [
    {
      "id": 139728896,
      "resource_type": "Ptable"
    },
    {
      "id": 169533705,
      "resource_type": "Subnet"
    },
    {
      "id": 170801529,
      "resource_type": "AuthSource"
    },
    {
      "id": 222559602,
      "resource_type": "CommonParameter"
    },
    {
      "id": 225912082,
      "resource_type": "Location"
    },
    {
      "id": 255448041,
      "resource_type": null
    },
    {
      "id": 291325508,
      "resource_type": "Operatingsystem"
    },
    {
      "id": 321349837,
      "resource_type": "Architecture"
    },
    {
      "id": 340438230,
      "resource_type": "Domain"
    },
    {
      "id": 343831726,
      "resource_type": "Realm"
    },
    {
      "id": 372277853,
      "resource_type": "User"
    },
    {
      "id": 503111935,
      "resource_type": "Medium"
    },
    {
      "id": 528928374,
      "resource_type": "Audit"
    },
    {
      "id": 557298380,
      "resource_type": "Usergroup"
    },
    {
      "id": 643462867,
      "resource_type": "Model"
    },
    {
      "id": 679608033,
      "resource_type": "FactValue"
    },
    {
      "id": 721145960,
      "resource_type": "Host"
    },
    {
      "id": 943645556,
      "resource_type": "Report"
    },
    {
      "id": 977587707,
      "resource_type": "Hostgroup"
    },
    {
      "id": 980424071,
      "resource_type": "Organization"
    },
    {
      "id": 1025364382,
      "resource_type": "ReportTemplate"
    },
    {
      "id": 1062414187,
      "resource_type": "Puppetclass"
    }
  ],
  "locations": [],
  "organizations": []
}

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
id
required

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.
description
optional

Validations:

  • Must be a String