Get an AI Index

Base URL
https://{kibana_url}
Auth

Fetches an AI Index by ID from the current space, including the ES|QL query derived from each trace.

Returns a 404 response when Context Engine is turned off in this space (contextEngine:enabled).

For more information, refer to the Context Engine documentation.

Required authorization

Privileges contextEngine:read

Path parameters

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.

aiIndexId string · min length: 1 · max length: 256 required

The unique identifier of the AI Index.

Responses

The requested AI Index.

application/json
automations object[] required

Automations associated with the AI Index.

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.

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.

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.

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:
type enum required
Values: relative
from string required

Date math relative to now, for example now-30d.

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.

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.

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.

No AI Index with the given ID exists in the current space, or 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.

Base URL
https://{kibana_url}