Configuration Items - Users API

List all users of a configuration item

List all People who are linked as a user to a configuration item with a specific ID.

GET /cis/:id/users

Response

Status: 200 OK

[
  {
    "name": "Ashok Kumar",
    "created_at": "2016-03-14T03:09:55-06:00",
    "sourceID": null,
    "updated_at": "2016-03-14T03:10:31-06:00",
    "manager": {
      "name": "Howard Tanner",
      "id": 5
    },
    "id": 30,
    "site": {
      "name": "Widget Data Center",
      "id": 13
    },
    "organization": {
      "name": "Widget Data Center, External IT",
      "id": 30
    },
    "disabled": false
  },
  {
    "name": "Barney Turban",
    "created_at": "2016-03-14T03:09:57-06:00",
    "sourceID": null,
    "updated_at": "2016-03-14T03:10:32-06:00",
    "manager": {
      "name": "Howard Tanner",
      "id": 5
    },
    "id": 58,
    "site": {
      "name": "Widget Data Center",
      "id": 13
    },
    "organization": {
      "name": "Widget Data Center, External IT",
      "id": 30
    },
    "disabled": false
  },
  "..."
]

The response contains these fields by default.

Predefined Filters

The following predefined filters are available:

• /cis/:id/users/disabled : List all disabled users of a configuration item with a specific ID
• /cis/:id/users/enabled : List all enabled users of a configuration item with a specific ID
• /cis/:id/users/internal : List all internal users of a configuration item with a specific ID

Add a user to a configuration item

Add a link between a configuration item with a specific ID and a Person with a specific ID.

POST /cis/:id/users/:person_id

Response

Status: 200 OK

{}

Remove a user from a configuration item

Remove the link between a configuration item with a specific ID and a Person with a specific ID.

DELETE /cis/:id/users/:person_id

Response

Status: 204 No Content

Remove all users from a configuration item

Remove all links between a configuration item with a specific ID and its users.

DELETE /cis/:id/users

Response

Status: 204 No Content