The SIEM app is now a part of the Elastic Security solution. Click here to view the current documentation.
IMPORTANT: No additional bug fixes or documentation updates will be released for this version.
« Set default SIEM UI connector Get current connector »
Elastic Docs ›SIEM Guide [7.8] ›SIEM APIs ›Cases API

Update case configurations

edit

Update case configurations

edit

Updates the connector’s case closure settings.

Connectors are used to interface with external systems. You can only call this method after you have created a connector (see Create connector). After a connector has been created and assigned, call Create or update an external incident to send cases to the external system.

Request URL

edit

PATCH <kibana host>:<port>/api/cases/configure

Request body

edit

A JSON object with these fields:

Name Type Description Required

connector_id

String

The ID of the connector you want to use for sending cases to external systems.

Yes

connector_name

String

The connector name.

No

closure_type

String

Determines whether a case is automatically closed in the SIEM app when it is pushed to ServiceNow. Valid values are:

  • close-by-pushing: SIEM app cases are automatically closed when they are pushed to ServiceNow.
  • close-by-user: SIEM app cases are not automatically closed.

No

version

String

The connector version.

Yes

Call Get current connector to retrieve the version value, and Find connectors to retrieve connector IDs.

Example request

edit

Changes the connector’s case closure option:

PATCH api/cases/configure
{
  "connector_id": "131d4448-abe0-4789-939d-8ef60680b498",
  "closure_type": "close-by-pushing",
  "version": "WzIwMiwxXQ=="
}

Response code

edit
200
Indicates a successful call.

Example response

edit
{
  "connector_id": "131d4448-abe0-4789-939d-8ef60680b498",
  "closure_type": "close-by-pushing",
  "connector_name": "ServiceNow",
  "created_at": "2020-03-30T13:31:38.083Z",
  "created_by": {
    "email": "admin@hms.gov.uk",
    "full_name": "Ms Admin",
    "username": "admin"
  },
  "updated_at": "2020-03-31T06:21:35.759Z",
  "updated_by": {
    "email": "admin@hms.gov.uk",
    "full_name": "Ms Admin",
    "username": "admin"
  },
  "version": "WzIwMywxXQ=="
}
« Set default SIEM UI connector Get current connector »