List AI Indices
Base URL
https://{kibana_url}
GET
/api/context_engine/ai_index
GET
/s/{space_id} /api/context_engine/ai_index
Auth
Stack
Experimental
The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.
Availability
Experimental
This functionality is experimental and is not ready for production usage. Experimental features may change or be removed at any time. Elastic will work to fix any issues, but experimental features are not subject to the support SLA of official GA features. Specific Support terms apply.
Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.
This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.
Lists up to 100 AI Indices in the current space that the caller can read. The response omits an AI Index when the caller cannot read its backing index. Empty AI Indices are still included. A caller with no read privilege on any index gets a 403 response.
The space comes from the request URL (/s/{spaceId}/…) or defaults to the default space. It cannot be specified in any other way.
Returns a 404 response when Context Engine is turned off in this space (contextEngine:enabled).
For more information, refer to the Context Engine documentation .
Privileges
contextEngine:read
Expand all
space_id
string optional
An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.
200
The AI Indices available to the caller in the current space.
application/json
ai_indices
object [] required
The AI Indices available to the caller in the current space.
−
Hide 11 properties
automations
object [] required
Automations associated with the AI Index.
−
Hide 2 properties
type
enum required
Values:
workflow
value
string required
The workflow ID.
date_created
string required
ISO 8601 timestamp of when the AI Index was created.
date_modified
string required
ISO 8601 timestamp of when the AI Index was last modified.
description
string
Human-readable description of the AI Index.
dest
object required
The data stream or index that backs the AI Index.
−
Hide 2 properties
type
enum required
The type of the backing store.
Values:
data_stream
index
value
string required
The data stream or index the AI Index is attached to.
feedback_analysis
object
The recurring feedback analysis, which reads agent signals and proposes improvement actions for the AI Index.
+
Show 6 properties
agent_id
string
Agent Builder agent ID that runs the analysis.
allowed_actions
enum []
Improvement actions the analysis may propose.
Values:
add_ki
edit_ki
remove_ki
add_workflow
edit_workflow
remove_workflow
add_source
edit_source
remove_source
enabled
boolean required
Whether the recurring feedback analysis is desired to run.
schedule
object
When the analysis runs.
+
Show 1 property
interval
string required
How often to analyze, for example 1h.
signal_filter
string
KQL narrowing which signals the analysis reads.
signal_time_range
union anyOf
Any of:
−
Hide 2 properties
type
enum required
Values:
relative
from
string required
Date math relative to now, for example now-30d.
−
Hide 2 properties
type
enum required
Values:
absolute
from
string required
ISO 8601 date to analyze signals since.
id
string required
The unique identifier of the AI Index.
managed
boolean required
Whether the AI Index is managed by a plugin and therefore immutable.
memory_enabled
boolean required
Whether this AI Index accepts memory writes.
sources
object [] required
Additional sources that provide context for the AI Index.
−
Hide 2 properties
type
enum required
esql for an ES|QL query, or connector for a data connector.
Values:
esql
connector
value
string required
An ES|QL query for esql, or a connector ID for connector.
traces
object [] required
Trace sources linked to this AI Index, each with its derived ES|QL query.
−
Hide 3 properties
query
string required
The ES|QL query derived from this trace source at read time.
type
enum required
elastic_agent for an Agent Builder agent, index for an index or data stream name or pattern, or esql for an ES|QL query.
Values:
elastic_agent
index
esql
value
string required
The trace source value.
403
The caller has no read privilege on any index, so Elasticsearch rejected the request.
application/json
error
string
The HTTP status text.
message
string required
A human-readable error message.
statusCode
number
The HTTP status code.
404
Context Engine is turned off in this space.
application/json
error
string
The HTTP status text.
message
string required
A human-readable error message.
statusCode
number
The HTTP status code.
Thank you for your feedback.
Base URL
https://{kibana_url}
Examples
Request
Console
1 / 2 languages
‹
›
1
GET kbn:/api/context_engine/ai_index
1
2
3
curl \
-X GET "https://${KIBANA_URL}/api/context_engine/ai_index" \
-H "Authorization: ApiKey ${API_KEY}"
Response
Example response listing the AI Indices the caller can read
Show more
The caller has no read privilege on any index
Show more
Context Engine is turned off in this space
Show more
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
"ai_indices": [
{
"automations": [],
"date_created": "2026-09-22T12:00:00.000Z",
"date_modified": "2026-09-22T12:00:00.000Z",
"description": "Knowledge about customer support cases.",
"dest": {
"type": "data_stream",
"value": "ai-index-ds-customer-support"
},
"id": "customer_support",
"managed": false,
"memory_enabled": true,
"sources": [
{
"type": "esql",
"value": "FROM support-cases | LIMIT 100"
}
],
"traces": []
}
]
}
1
2
3
4
5
{
"error": "Forbidden",
"message": "security_exception\n\tRoot causes:\n\t\tsecurity_exception: action [indices:data/read/msearch] is unauthorized for user [jdoe] with effective roles [support_reader], this action is granted by the index privileges [read,all]",
"statusCode": 403
}
1
2
3
4
5
{
"error": "Not Found",
"message": "Not Found",
"statusCode": 404
}