/kibana-cases | Type: Application | PCID required: Yes
Tools
kibana_cases_add_case_comment_default_space
Add a case comment or alert Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
body | object | Yes | — | The add comment to case API request body varies depending on whether you are adding an alert or a comment. |
kibana_cases_add_case_file_default_space
Attach a file to a case Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
file | string | Yes | — | The file being attached to the case. |
filename | string | No | — | The desired name of the file being attached to the case, it can be different than the name of the file in the filesystem. This should not include the file extension. |
kibana_cases_create_case_default_space
Create a case Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
assignees | object[] | No | — | An array containing users that are assigned to the case. |
category | string | No | — | A word or phrase that categorizes the case. |
connector | object | Yes | — | The connector value |
customFields | object[] | No | — | Custom field values for a case. Any optional custom fields that are not specified in the request are set to null. |
description | string | Yes | — | The description for the case. |
owner | string | Yes | — | The application that owns the cases: Stack Management, Observability, or Elastic Security. |
settings | object | Yes | — | An object that contains the case settings. |
severity | string | No | — | The severity of the case. |
tags | string[] | Yes | — | The words and phrases that help categorize cases. It can be an empty array. |
title | string | Yes | — | A title for the case. |
kibana_cases_delete_case_comment_default_space
Delete a case comment or alert Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
commentId | string | Yes | — | The identifier for the comment. To retrieve comment IDs, use the get case or search cases (_find) APIs. |
kibana_cases_delete_case_comments_default_space
Delete all case comments and alerts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
kibana_cases_delete_case_default_space
Delete cases Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ids | string[] | Yes | — | The cases that you want to removed. To get the case identifiers, use the search cases (_find) API. In the Dev Console, you can specify the array of cases in the following format: ids=["e58e77e3-ef8e-4251-926f-efb115f3c4ec"]. In curl, all non-ASCII characters must be URL encoded. For example: ids=%5B%22e58e77e3-ef8e-4251-926f-efb115f3c4ec%22%5D |
kibana_cases_find_case_activity_default_space
Find case activity Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
page | integer | No | — | The page number to return. |
perPage | integer | No | — | The number of items to return. Limited to 100 items. |
sortOrder | string | No | — | Determines the sort order. |
types | string[] | No | — | Determines the types of user actions to return. |
kibana_cases_find_case_comments_default_space
Find case comments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
page | integer | No | — | The page number to return. |
perPage | integer | No | — | The number of items to return. Limited to 100 items. |
sortOrder | string | No | — | Determines the sort order. |
kibana_cases_find_case_connectors_default_space
Get case connectorskibana_cases_find_cases_default_space
Search cases Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
assignees | string[] | No | — | Filters the returned cases by assignees. Valid values are none or unique identifiers for the user profiles. These identifiers can be found by using the suggest user profile API. |
category | string[] | No | — | Filters the returned cases by category. |
defaultSearchOperator | string | No | — | he default operator to use for the simple_query_string. |
from | string | No | — | Returns only cases that were created after a specific date. The date must be specified as a KQL data range or date match expression. |
owner | string[] | No | — | A filter to limit the response to a specific set of applications. If this parameter is omitted, the response contains information about all the cases that the user has access to read. |
page | integer | No | — | The page number to return. |
perPage | integer | No | — | The number of items to return. Limited to 100 items. |
reporters | string[] | No | — | Filters the returned cases by the user name of the reporter. |
search | string | No | — | An Elasticsearch simple_query_string query that filters the objects in the response. |
searchFields | string[] | No | — | The fields to perform the simple_query_string parsed query against. |
severity | string | No | — | The severity of the case. |
sortField | string | No | — | Determines which field is used to sort the results. |
sortOrder | string | No | — | Determines the sort order. |
status | string | No | — | Filters the returned cases by state. |
tags | string[] | No | — | Filters the returned cases by tags. |
to | string | No | — | Returns only cases that were created before a specific date. The date must be specified as a KQL data range or date match expression. |
kibana_cases_get_by_alert_default_space
Get cases for an alert Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
alertId | string | Yes | — | An identifier for the alert. |
owner | string[] | No | — | A filter to limit the response to a specific set of applications. If this parameter is omitted, the response contains information about all the cases that the user has access to read. |
kibana_cases_get_case_alerts_default_space
Get all alerts for a case Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
kibana_cases_get_case_comment_default_space
Get a case comment or alert Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
commentId | string | Yes | — | The identifier for the comment. To retrieve comment IDs, use the get case or search cases (_find) APIs. |
kibana_cases_get_case_configuration_default_space
Get case settings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string[] | No | — | A filter to limit the response to a specific set of applications. If this parameter is omitted, the response contains information about all the cases that the user has access to read. |
kibana_cases_get_case_default_space
Get case information Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
kibana_cases_get_case_reporters_default_space
Get case creators Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string[] | No | — | A filter to limit the response to a specific set of applications. If this parameter is omitted, the response contains information about all the cases that the user has access to read. |
kibana_cases_get_case_tags_default_space
Get case tags Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
owner | string[] | No | — | A filter to limit the response to a specific set of applications. If this parameter is omitted, the response contains information about all the cases that the user has access to read. |
kibana_cases_push_case_default_space
Push a case to an external service Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
connectorId | string | Yes | — | An identifier for the connector. To retrieve connector IDs, use the find connectors API. |
body | object | No | — | Request body |
kibana_cases_set_case_configuration_default_space
Add case settings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
closure_type | string | Yes | — | Indicates whether a case is automatically closed when it is pushed to external systems (close-by-pushing) or not automatically closed (close-by-user). |
connector | object | Yes | — | An object that contains the connector configuration. |
customFields | object[] | No | — | Custom fields case configuration. |
owner | string | Yes | — | The application that owns the cases: Stack Management, Observability, or Elastic Security. |
templates | object[] | No | — | The templates value |
kibana_cases_update_case_comment_default_space
Update a case comment or alert Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
caseId | string | Yes | — | The identifier for the case. To retrieve case IDs, use the search cases (_find) API. All non-ASCII characters must be URL encoded. |
body | object | Yes | — | The update case comment API request body varies depending on whether you are updating an alert or a comment. |
kibana_cases_update_case_configuration_default_space
Update case settings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
configurationId | string | Yes | — | An identifier for the configuration. |
closure_type | string | No | — | Indicates whether a case is automatically closed when it is pushed to external systems (close-by-pushing) or not automatically closed (close-by-user). |
connector | object | No | — | An object that contains the connector configuration. |
customFields | object[] | No | — | Custom fields case configuration. |
templates | object[] | No | — | The templates value |
version | string | Yes | — | The version of the connector. To retrieve the version value, use the get configuration API. |
kibana_cases_update_case_default_space
Update cases Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cases | object[] | Yes | — | An array containing one or more case objects. |

