Project Tasks - Successors API

List all successors of a project task

List all successors of a project task with a specific ID:

GET /project_tasks/:id/successors

Response

status: 200 OK
[
  {
    "id": 24554,
    "sourceID": null,
    "phase": {
      "completed_at": null,
      "created_at": "2016-12-23T05:09:06-06:00",
      "id": 314,
      "name": "Implementation",
      "position": 3,
      "started_at": "2016-12-23T05:09:06-06:00",
      "status": "in_progress",
      "updated_at": "2016-12-23T05:09:06-06:00"
    },
    "subject": "Go-live",
    "category": "milestone",
    "status": "registered",
    "completion_target_at": "2017-03-01T09:43:00-06:00",
    "finished_at": null,
    "created_at": "2017-01-18T09:42:39-06:00",
    "updated_at": "2017-01-18T09:42:39-06:00"
  },
  {
    "id": 24553,
    "sourceID": null,
    "phase": {
      "completed_at": null,
      "created_at": "2016-12-23T05:09:06-06:00",
      "id": 314,
      "name": "Implementation",
      "position": 3,
      "started_at": "2016-12-23T05:09:06-06:00",
      "status": "in_progress",
      "updated_at": "2016-12-23T05:09:06-06:00"
    },
    "subject": "Training",
    "category": "activity",
    "status": "in_progress",
    "completion_target_at": "2017-03-01T09:43:00-06:00",
    "finished_at": null,
    "created_at": "2017-01-18T09:42:39-06:00",
    "updated_at": "2017-02-23T10:18:52-06:00"
  },
  "..."
]

The response contains these fields by default.

Add a successor to a project task

Add a successor link between a project task with a specific ID and another project task with a specific ID.

POST /project_tasks/:id/successors/:project_task_id

Response

status: 200 OK
{}

Remove a successor from a project task

Remove the successor link between a project task with a specific ID and another project task with a specific ID.

DELETE /project_tasks/:id/successors/:project_task_id

Response

status: 204 No Content

Remove all successors from a project task

Remove all successor links between a project task with a specific ID and its successors.

DELETE /project_tasks/:id/successors

Response

status: 204 No Content