Risks - Organizations API

List all organizations of a risk

List all organizations who are linked as an organization to a risk with a specific ID.

GET /risks/:id/organizations

Response

Status: 200 OK

[
  {
    "id": 44,
    "sourceID": null,
    "name": "Widget Data Center, External IT",
    "parent": {
      "id": 6,
      "name": "Widget Data Center"
    },
    "manager": {
      "id": 6,
      "name": "Howard Tanner"
    },
    "created_at": "2016-03-22T21:02:50-05:00",
    "updated_at": "2016-03-25T16:54:52-05:00"
  },
  {
    "id": 50,
    "sourceID": null,
    "name": "Widget North America, Finance",
    "parent": {
      "id": 51,
      "name": "Widget North America, Inc."
    },
    "manager": {
      "id": 120,
      "name": "Carolyn Goldrat"
    },
    "created_at": "2016-03-22T21:02:50-05:00",
    "updated_at": "2016-03-22T21:03:36-05:00"
  },
  "..."
]

The response contains these fields by default.

Predefined Filters

The following predefined filters are available:

• /risks/:id/organizations/disabled : List all disabled organizations of a risk with a specific ID
• /risks/:id/organizations/enabled : List all enabled organizations of a risk with a specific ID
• /risks/:id/organizations/external : List all external organizations of a risk with a specific ID
• /risks/:id/organizations/internal : List all internal organizations of a risk with a specific ID
• /risks/:id/organizations/directory : List all organizations of a risk with a specific ID registered in the directory account of the support domain account from which the data is requested
• /risks/:id/organizations/support_domain : List all organizations of a risk with a specific ID registered in the account from which the data is requested
• /risks/:id/organizations/managed_by_me : List all organizations of a risk with a specific ID which manager or substitute is the API user

Add an organization to a risk

Add a link between a risk with a specific ID and an organization with a specific ID.

POST /risks/:id/organizations/:organization_id

Response

Status: 200 OK

{}

Remove an organization from a risk

Remove the link between a risk with a specific ID and an organization with a specific ID.

DELETE /risks/:id/organizations/:organization_id

Response

Status: 204 No Content

Remove all organizations from a risk

Remove all links between a risk with a specific ID and its organizations.

DELETE /risks/:id/organizations

Response

Status: 204 No Content