> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Elastic Search

> Connect Elastic Search to xpander and give agents its 111 actions: how to create the API key and connect it, and which actions to hold for approval.

<Badge color="blue">HTTP API connector</Badge>

An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to the server address you enter when connecting and carry an API key.

## What the skill can do

API connector: 111 actions, as they appear in the skill panel. 64 of them create, change or delete something in Elastic Search; mark those under **These actions need approval** when you add the skill to an agent.

* **Cluster administration** (14): Elasticsearch Cluster Admin Get Cluster Info, Elasticsearch Security Get Api Keys, Elasticsearch Security Invalidate Api Key, Elasticsearch Security List Roles, Elasticsearch Security Authenticate User, Elasticsearch Security Create Api Key, Elasticsearch Security List Users, Elasticsearch Cluster Admin Get Health By Index, Elasticsearch Cluster Admin Update Cluster Settings, Elasticsearch Cluster Admin Get Cluster Stats, Elasticsearch Security Create Role By Name, Elasticsearch Security Check User Privileges, Elasticsearch Cluster Admin Get Cluster Health, Elasticsearch Cluster Admin Get Cluster Settings
* **Query and search** (13): Elasticsearch Search Close Point In Time, Elasticsearch Search Get Async Search By Id, Elasticsearch Search Get Scroll Results, Elasticsearch Search Clear Scroll Context, Elasticsearch Search Delete Async Search By Id, Elasticsearch Search Query All Indices, Elasticsearch Search Get Field Capabilities, Elasticsearch Search Run Multi Search By Index, Elasticsearch Search Open Point In Time, Elasticsearch Search Submit Async Search, Elasticsearch Search Query String By Index, Elasticsearch Search Query By Index, Elasticsearch Search Get Terms Enum By Index
* **Document operations** (9): Elasticsearch Document Get Multiple Documents, Elasticsearch Document Create Document By Id, Elasticsearch Document Delete Document By Id, Elasticsearch Document Update Document By Id, Elasticsearch Search Count Documents By Index, Elasticsearch Document Index Document Auto Id, Elasticsearch Document Get Document Source By Id, Elasticsearch Document Index Document By Id, Elasticsearch Document Get Document By Id
* **Index administration** (9): Elasticsearch Index Admin Create Index, Elasticsearch Index Admin Clone Index To Target, Elasticsearch Index Admin Close Index, Elasticsearch Index Admin Flush Index, Elasticsearch Index Admin Refresh Index, Elasticsearch Index Admin Get Index Stats, Elasticsearch Index Admin Force Merge Index, Elasticsearch Index Admin Delete Index, Elasticsearch Index Admin Open Index
* **Bulk ingestion** (7): Elasticsearch Cat Views List Indices, Elasticsearch Bulk Ingest Reindex Documents, Elasticsearch Bulk Ingest Run Bulk Operations, Elasticsearch Bulk Ingest Run Bulk By Index, Elasticsearch Bulk Ingest Delete By Query By Index, Elasticsearch Index Admin Get Index, Elasticsearch Bulk Ingest Update By Query By Index
* **Alias management** (7): Elasticsearch Cat Views List Aliases, Elasticsearch Cat Views List Shards, Elasticsearch Alias Manage Get All Aliases, Elasticsearch Alias Manage Update Aliases Atomic, Elasticsearch Alias Manage Rollover Index By Alias, Elasticsearch Alias Manage Create Alias By Index Name, Elasticsearch Alias Manage Delete Alias By Index Name
* **Snapshot and restore** (7): Elasticsearch Snapshot Delete Repository, Elasticsearch Snapshot List Repositories, Elasticsearch Snapshot Create Repository, Elasticsearch Snapshot Delete Snapshot, Elasticsearch Snapshot Get Snapshot, Elasticsearch Snapshot Create Snapshot, Elasticsearch Snapshot Restore Snapshot
* **Diagnostic inspection** (5): Elasticsearch Cat Views Get Cluster Health, Elasticsearch Diagnostic Explain Shard Allocation, Elasticsearch Cat Views Get Thread Pool Stats, Elasticsearch Cat Views Get Document Count, Elasticsearch Cat Views List Shard Recoveries
* **Template management** (5): Elasticsearch Template Manage Delete Index Template, Elasticsearch Template Manage Create Component Template, Elasticsearch Template Manage Create Index Template, Elasticsearch Template Manage Get Component Template, Elasticsearch Template Manage Get Index Template
* **Esql and sql** (5): Elasticsearch Esql Sql Run Esql Query Async, Elasticsearch Esql Sql Run Esql Query, Elasticsearch Esql Sql Get Esql Async Result By Id, Elasticsearch Esql Sql Run Sql Query, Elasticsearch Esql Sql Translate Sql Query
* **Task management** (5): Elasticsearch Cat Views List Tasks, Elasticsearch Task Manage Get Pending Tasks, Elasticsearch Task Manage Get Task By Id, Elasticsearch Task Manage List Tasks, Elasticsearch Task Manage Cancel Task By Id
* **Lifecycle policy** (4): Elasticsearch Lifecycle Get Lifecycle Policy, Elasticsearch Lifecycle Create Lifecycle Policy, Elasticsearch Lifecycle Delete Lifecycle Policy, Elasticsearch Lifecycle Explain Lifecycle By Index
* **Inference service** (4): Elasticsearch Inference Create Endpoint By Type, Elasticsearch Inference Run Inference By Id, Elasticsearch Inference Delete Endpoint By Id, Elasticsearch Inference Get Endpoint By Id
* **Ingest pipeline** (4): Elasticsearch Ingest Pipeline Get Pipeline By Id, Elasticsearch Ingest Pipeline Delete Pipeline By Id, Elasticsearch Ingest Pipeline Create Pipeline By Id, Elasticsearch Ingest Pipeline Simulate Pipeline By Id
* **Data stream management** (4): Elasticsearch Data Stream Get Data Stream By Name, Elasticsearch Data Stream Create Data Stream By Name, Elasticsearch Data Stream Get Data Stream Stats, Elasticsearch Data Stream Delete Data Stream By Name
* **Mapping and settings** (4): Elasticsearch Mapping Settings Update Mapping, Elasticsearch Mapping Settings Get Index Settings, Elasticsearch Mapping Settings Update Index Settings, Elasticsearch Mapping Settings Get Mapping
* **Node monitoring** (3): Elasticsearch Cat Views List Nodes, Elasticsearch Node Monitor Get Nodes Stats, Elasticsearch Node Monitor Get Nodes Info
* **Document** (1): Elasticsearch Document Check Document Exists By Id
* **Indices** (1): Elasticsearch Index Admin Check Index Exists

## Connect Elastic Search

In Xpander Chat, open the agent's settings, click **Add skill**, and search for **Elastic Search**. The connect dialog asks for a connection name and whether the connection is for the **Organization** (one shared account) or **Personal** (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person's own sign-in; see [whose credential a shared agent uses](/use/agents/permissions#whose-credential-a-shared-agent-uses).

Elastic Search connects with an API key. Create the key in Elastic Search, paste it into the dialog, and click **Connect**. The key goes to the vault; the agent references it and never sees the value.

* **Server URL**: paste the Elasticsearch endpoint from your deployment. Self-managed clusters are usually `http://localhost:9200`.
* **API key**: create one with `POST /_security/api_key` and paste the `encoded` value. Paste it bare, xpander adds the `ApiKey` prefix for you.
* **Check it works**: run the **Authenticate** action (`GET /_security/_authenticate`).

Calls go to `{scheme}://{host}:{port}{basePath}`.

## Give an agent the Elastic Search skill

Once Elastic Search is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **Elastic Search**. Enable only the action groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](/use/skills).

## Related Resources

* [Skills](/use/skills)
* [Elastic Search API reference](https://www.elastic.co/docs/api/doc/elasticsearch)
