CI Lifecycle Management API - PATCH /now/cilifecyclemgmt/leases/{sys_id}

Extend the CI-action-lease time for the registered user. If the previous lease has expired, the new lease time starts now.

URL format

Versioned URL: api/now/v1/cilifecyclemgmt/leases/{sys_id}

Default URL: api/now/cilifecyclemgmt/leases/{sys_id}

Supported request parameters

Table 1. Parameters
Parameter Description
sys_id The CI's sys_id.
requestorid A sys_id of a workflow context, or the GUID returned from the registerOperator (POST) interface.
actionName The CI action name.
leaseTime Time duration for which the lease is valid for specified CI Action. In the format HH:MM:SS.

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, seeREST 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 lease time has been set.
  • errors - list of errors.