Get an AI Index

Base URL: https://{kibana_url}

GET /api/context_engine/ai_index/{aiIndexId}
GET /s/{space_id}/api/context_engine/ai_index/{aiIndexId}

Refer to Spaces for more information.

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

Authentication

Api key

Authorization: <value>

These APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example: Authorization: ApiKey base64AccessApiKey

Basic

Authorization: Basic <credentials>

Path parameters

Responses

The requested AI Index.

application/json

automations object[] required: Automations associated with the AI Index.
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.
feedback_analysis object: The recurring feedback analysis, which reads agent signals and proposes improvement actions for the AI Index.
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.
traces object[] required: Trace sources linked to this AI Index, each with its derived ES|QL query.

No AI Index with the given ID exists in the current space, or Context Engine is turned off in this space.

application/json

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

GET kbn:/api/context_engine/ai_index/customer_support

curl Shell

curl \
  -X GET "https://${KIBANA_URL}/api/context_engine/ai_index/customer_support" \
  -H "Authorization: ApiKey ${API_KEY}"

Response

Example response returning an AI Index by ID

{
  "automations": [
    {
      "type": "workflow",
      "value": "8f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"
    }
  ],
  "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": [
    {
      "query": "FROM traces-agent_builder.otel-default\n| WHERE attributes.gen_ai.agent.id IN (\u0022elastic-ai-agent\u0022)",
      "type": "elastic_agent",
      "value": "elastic-ai-agent"
    }
  ]
}

{
  "error": "Not Found",
  "message": "Not Found",
  "statusCode": 404
}