API Evangelist enrichment overlay for the Illumex API

overlay: 1.0.0
info:
  title: API Evangelist enrichment overlay for the Illumex API
  version: 1.0.0
extends: openapi/illumex-ai-openapi.json
x-generated: '2026-10-27'
x-method: generated
x-source:
  - openapi/illumex-ai-openapi.json
  - https://web.archive.org/web/20260115042443/https://illumex.ai/documentation/api/
  - https://web.archive.org/web/20251211204244/https://illumex.ai/documentation/illumex-mcp-tools/
x-rationale: >-
  The archived Illumex OpenAPI (openapi/illumex-ai-openapi.json, OpenAPI 3.0.0, 256
  operations) ships with an EMPTY `servers:` array, an EMPTY `components.securitySchemes`
  and no root `security:` requirement — the only thing published in the SwaggerUIBundle
  embed captured by the Wayback Machine on 2026-01-15. illumex was acquired by NVIDIA
  in February 2026 and the live site no longer resolves, so re-probing an auth scheme
  or discovering a base URL is impossible. This overlay therefore does NOT invent a
  `servers[]` entry and does NOT add a `securitySchemes` block that cannot be
  verified. It annotates the spec with API Evangelist enrichment pointers (dormancy
  state, MCP crosswalk, agent skills) using `x-apievangelist-*` extensions, which
  are safe to layer onto the archival spec. Apply with any Overlay 1.0.0 processor.

actions:
  - target: $.info
    description: Annotate the archived spec with its lifecycle state so a consumer immediately sees it is dormant.
    update:
      x-apievangelist-status: dormant
      x-apievangelist-status-detail: >-
        illumex was acquired by NVIDIA in February 2026 and illumex.ai no longer
        resolves (no A record from 8.8.8.8, 1.1.1.1 or 9.9.9.9 on 2026-10-27).
        This specification is retained as the historical public API surface and is
        not currently reachable at any live host.
      x-apievangelist-acquisition:
        acquirer: NVIDIA
        acquisition_date: '2026-02'
        sources:
          - https://www.calcalistech.com/ctechnews/article/hkrcgl5dbx
          - https://en.globes.co.il/en/article-nvidia-acquires-israeli-data-co-illumex-1001535871
      x-apievangelist-source: >-
        Extracted verbatim from the SwaggerUIBundle spec block embedded in
        illumex.ai/documentation/api/ as captured by the Wayback Machine on
        2026-01-15. `info.title` is "Illumex API"; `servers[]` was empty in the
        embedded spec and the live base URL is unknown post-acquisition, so this
        overlay deliberately does not populate `servers:`.

  - target: $
    description: >-
      Cross-reference the companion artifacts in the API Evangelist repo so a tool
      walking the spec can find the agent surfaces (MCP tool list, tool crosswalk,
      skills, llms.txt).
    update:
      x-apievangelist-artifacts:
        apis_yml: apis.yml
        mcp_manifest: mcp/illumex-ai-mcp.yml
        tool_crosswalk: mcp/illumex-ai-tool-crosswalk.yml
        llms_txt: llms/illumex-ai-llms.txt
        skills_index: skills/_index.yml
        domain_security: security/illumex-ai-domain-security.yml
      x-apievangelist-mcp-surface:
        note: >-
          illumex also published an "illumex MCP Tools" documentation page listing
          10 tools under the `/mcp/*` path prefix (sibling to this `/api/*` surface).
          None of those `/mcp/*` paths appear as operations in this OpenAPI — the
          MCP surface was documented separately. See mcp/illumex-ai-mcp.yml for the
          full tool list and mcp/illumex-ai-tool-crosswalk.yml for the mapping back
          to operationIds in this spec.
        path_prefix: /mcp
        tool_count: 10
        source: https://web.archive.org/web/20251211204244/https://illumex.ai/documentation/illumex-mcp-tools/

  - target: $.tags
    description: Note each tag as part of the archived surface so downstream processors treat them as read-only.
    update:
      x-apievangelist-tags-note: >-
        30 tags in the archived spec (Analysis, Analytics, Attributes, BI, Comments,
        Connections, Datasources, Discussions, Exploration, Glossary, Lineage,
        Looker, Metrics, Notifications, Omni, OmniConversation, OmniMessage,
        Powerbi, Properties, Queries, Search, Shortcuts, Slack, Starred,
        Suggestions, Tags, Teams, Terms, Users, Zones). All operations are
        historical — no live endpoint remains.