﻿---
title: Kibana action steps
description: Learn about Kibana action steps for automating tasks such as creating cases and managing alerts in workflows.
url: https://www.elastic.co/elastic/docs-builder/docs/2856/explore-analyze/workflows/steps/kibana
products:
  - Elastic Cloud Enterprise
  - Elastic Cloud Hosted
  - Elastic Cloud Serverless
  - Elastic Cloud on Kubernetes
  - Elastic Stack
  - Kibana
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview since 9.3
---

# Kibana action steps
Kibana actions are built-in steps that allow your workflows to interact with Kibana APIs. You can automate tasks such as creating cases, updating alerts, or interacting with other Kibana features.
All Kibana actions are automatically authenticated using the permissions or API key of the user executing the workflow.
There are two ways to use Kibana actions:
- [Named actions](#named-actions): Common Kibana operations accessible through a simplified, high-level interface
- [Generic request actions](#generic-request-actions): Actions that provide full control over the HTTP request for advanced use cases


## Named actions

Named actions provide a simplified, high-level interface for common Kibana operations. Each action type corresponds to a specific Kibana function.
To view the available named actions, click **Actions menu** and select **Kibana**. For operations that are not available as a named action, use the [generic request action](#generic-request-actions).
The following example demonstrates a common use case.

### Example: Create a case

The `kibana.createCaseDefaultSpace` action opens a new security case. The parameters in the `with` block are specific to this action.
```yaml
steps:
  - name: create_a_case
    type: kibana.createCaseDefaultSpace
    with:
      title: "Suspicious Login Detected"
      description: "Automated case created by workflow. Host '{{ event.alerts[0].host.name }}' exhibited unusual activity."
      tags: ["workflow", "automated-response"]
      severity: "critical"
      connector:
        id: "none"
        name: "none"
        type: ".none"
```


## Generic request actions

The generic `kibana.request` type gives you full control over the HTTP request. Use it for:
- Accessing [Kibana APIs](https://www.elastic.co/docs/api/doc/kibana/) that do not have a named action
- Advanced use cases that require specific headers or query parameters not exposed by a named action

<note>
  We recommend using named actions whenever possible. They are more readable and provide a stable interface for common operations.
</note>

Use the following parameters in the `with` block to configure the request:

| Parameter | Required               | Description                                                                                          |
|-----------|------------------------|------------------------------------------------------------------------------------------------------|
| `method`  | No (defaults to `GET`) | The HTTP method (`GET`, `POST`, `PUT`, or `DELETE`)                                                  |
| `path`    | Yes                    | The API endpoint path, starting with `/api/`                                                         |
| `body`    | No                     | The JSON request body                                                                                |
| `query`   | No                     | An object representing URL query string parameters                                                   |
| `headers` | No                     | Custom HTTP headers to include in the request. `kbn-xsrf` and `Content-Type` are added automatically |

<note>
  You do not need to pass an `Authorization` header. The workflow engine automatically attaches the correct authentication headers based on the execution context. Do not manage or pass API keys or secrets in the `headers` block.
</note>


### Example: Unisolate an endpoint

This example uses the generic request action to call the Security endpoint management API to unisolate a host ([Release an isolated endpoint](https://www.elastic.co/docs/api/doc/kibana/operation/operation-endpointunisolateaction)).
```yaml
steps:
  - name: unisolate_endpoint_with_case
    type: kibana.request
    with:
      method: POST
      path: /api/endpoint/action/unisolate
      body:
        endpoint_ids: ["{{event.alerts[0].elastic.agent.id}}"]
        comment: "Unisolating endpoint as part of automated cleanup."
```