Tasks - Service Instances API

List all service instances of a task

List all service instances of a task with a specific ID.

GET /tasks/:id/service_instances

Response

Status: 200 OK
[
  {
    "name": "Amsterdam Network",
    "created_at": "2016-03-14T03:10:38-06:00",
    "sourceID": null,
    "updated_at": "2016-03-14T03:10:38-06:00",
    "service": {
      "name": "Network Connectivity",
      "id": 20,
      "provider": {
        "name": "Widget Data Center, External IT",
        "id": 30
      }
    },
    "support_team": {
      "name": "Operations",
      "id": 11
    },
    "id": 23,
    "status": "in_production"
  },
  {
    "name": "AT&T Smart Phone for Widget Data Center, External IT",
    "created_at": "2016-03-14T03:10:39-06:00",
    "sourceID": null,
    "updated_at": "2016-03-14T03:11:39-06:00",
    "service": {
      "name": "Smart Phone",
      "account": {
        "name": "Widget North America",
        "id": "wna"
      },
      "id": 45,
      "provider": {
        "name": "Widget North America, Information Technology",
        "account": {
          "name": "Widget North America",
          "id": "wna"
        },
        "id": 45
      }
    },
    "account": {
      "name": "Widget North America",
      "id": "wna"
    },
    "support_team": {
      "name": "End-User Support, Chicago",
      "account": {
        "name": "Widget North America",
        "id": "wna"
      },
      "id": 16
    },
    "id": 133,
    "status": "in_production"
  },
  "..."
]

The response contains these fields by default.

Predefined Filters

The following predefined filters are available:

Add a service instance to a task

Add a link between a task with a specific ID and a service instance with a specific ID.

POST /tasks/:id/service_instances/:service_instance_id

Response

Status: 200 OK
{}

Remove a service instance from a task

Remove the link between a task with a specific ID and a service instance with a specific ID.

DELETE /tasks/:id/service_instances/:service_instance_id

Response

Status: 204 No Content

Remove all service instances from a task

Remove all links between a task with a specific ID and its service instances.

DELETE /tasks/:id/service_instances

Response

Status: 204 No Content