Configuration Items - Contracts API

List all contracts of a configuration item

List all contracts of a configuration item with a specific ID.

GET /cis/:id/contracts

Response

Status: 200 OK

[
  {
    "id": 84,
    "sourceID": null,
    "name": "0012PQ-MSAS-000605491 - Microsoft Software Assurance Support & Maintenance Agreement",
    "status": "active",
    "category": "support_and_maintenance_contract",
    "created_at": "2016-03-13T02:10:15-05:00",
    "supplier": {
      "id": 27,
      "name": "Microsoft Corporation"
    },
    "updated_at": "2016-03-13T02:10:15-05:00"
  },
  {
    "id": 87,
    "sourceID": null,
    "name": "0106-SAPUS-00046608 - SAP Enterprise Support for SAP ERP Central Component",
    "status": "active",
    "category": "support_and_maintenance_contract",
    "created_at": "2016-03-13T02:10:15-05:00",
    "supplier": {
      "id": 29,
      "name": "SAP AG"
    },
    "updated_at": "2016-03-13T02:10:15-05:00"
  },
  "..."
]

The response contains these fields by default.

Predefined Filters

The following predefined filters are available:

• /cis/:id/contracts/active : List all active contracts of a configuration item with a specific ID
• /cis/:id/contracts/inactive : List all inactive contracts of a configuration item with a specific ID

Add a contract to a configuration item

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

POST /cis/:id/contracts/:contract_id

Response

Status: 200 OK

{}

Remove a contract from a configuration item

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

DELETE /cis/:id/contracts/:contract_id

Response

Status: 204 No Content

Remove all contracts from a configuration item

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

DELETE /cis/:id/contracts

Response

Status: 204 No Content