CI Lifecycle Management API - POST /now/cilifecyclemgmt/statuses

Set the operational state for list of CIs.

URL format

Versioned URL: api/now/v1/cilifecyclemgmt/statuses

Default URL: api/now/cilifecyclemgmt/statuses

Supported request parameters

Table 1. Parameters
Parameter Description
requestorId A sys_id of a workflow context, or the GUID returned from the registerOperator() method.
sysIds A comma separated list of CI sys_ids.
opsLabel This is the string label of an operational_status choice.
oldOpsLabels (Optional) A comma separated list of old CI states that all CIs should be in.

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 2. Request headers
Header Description
Table 3. Response headers
Header Description

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST response codes .

Table 4. Status codes
Status code Description
200 Indicates the request completed successfully.

Response payload

A JSON formatted string with name-value pairs for
  • result - true if the state is set for all CIs in the list; otherwise, false.
  • errors - list of errors.