Risks - Projects API

List all projects of a risk

List all projects who are linked as a project to a risk with a specific ID.

GET /risks/:id/projects

Response

Status: 200 OK

[
  {
    "id": 7345,
    "sourceID": null,
    "subject": "Warehouse Ordering (WHO)",
    "category": "large",
    "status": "in_progress",
    "completion_target_at": "2017-01-13T09:00:00-06:00",
    "completed_at": null,
    "service": {
      "id": 41,
      "name": "Warehouse Management",
      "provider": {
        "id": 44,
        "name": "Widget Data Center,  External IT",
        "account": {
          "id": "pro-product",
          "name": "Widget International"
        }
      },
      "localized_name": "Warehouse Management"
    },
    "created_at": "2016-11-13T13:17:00-06:00",
    "updated_at": "2016-12-23T05:09:09-06:00"
  },
  {
    "id": 4021,
    "sourceID": null,
    "subject": "Best in Customer Satisfaction (BICS)",
    "category": "medium",
    "status": "in_progress",
    "completion_target_at": "2017-03-21T10:51:00-05:00",
    "completed_at": null,
    "service": {
      "id": 24,
      "name": "Service Management (ITRP)",
      "provider": {
        "id": 44,
        "name": "Widget Data Center,  External IT",
        "account": {
          "id": "pro-product",
          "name": "Widget International"
        }
      },
      "localized_name": "Service Management (ITRP)"
    },
    "created_at": "2016-08-05T16:12:00-05:00",
    "updated_at": "2017-01-18T16:15:34-06:00"
  }
]

The response contains these fields by default.

Predefined Filters

The following predefined filters are available:

• /risks/:id/projects/completed : List all completed projects of a risk with a specific ID
• /risks/:id/projects/open : List all open projects of a risk with a specific ID
• /risks/:id/projects/managed_by_me : List all projects of a risk with a specific ID which manager is the API user

Add a project to a risk

Add a link between a risk with a specific ID and a project with a specific ID.

POST /risks/:id/projects/:project_id

Response

Status: 200 OK

{}

Remove a project from a risk

Remove the link between a risk with a specific ID and a project with a specific ID.

DELETE /risks/:id/projects/:project_id

Response

Status: 204 No Content

Remove all projects from a risk

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

DELETE /risks/:id/projects

Response

Status: 204 No Content