Skip to content

[9.4] [Docs][Visualizations API] Add introduction and get-started overlay (#262595)#263007

Merged
kibanamachine merged 1 commit into
elastic:9.4from
kibanamachine:backport/9.4/pr-262595
Apr 14, 2026
Merged

[9.4] [Docs][Visualizations API] Add introduction and get-started overlay (#262595)#263007
kibanamachine merged 1 commit into
elastic:9.4from
kibanamachine:backport/9.4/pr-262595

Conversation

@kibanamachine
Copy link
Copy Markdown
Contributor

Backport

This will backport the following commits from main to 9.4:

Questions ?

Please refer to the Backport tool documentation

…lastic#262595)

## Summary

Adds the tag description overlay for the Visualizations API, including
an intro, when to use, get started prereqs, a runnable "Try it now"
example, a visualization structure overview, and a chart types table.

- `oas_docs/overlays/visualizations.overlays.yaml` — new tag description
overlay
- `oas_docs/makefile` — wires the overlay into the stateful OAS pipeline

Mirrors the scope and structure of the Dashboards API PR 1/4 (elastic#262396).
No output files committed — the overlay takes effect when the publishing
pipeline runs against the full bundle.

**Preview:**
https://bump.sh/elastic/hub/elastic-apis/doc/visualizations-api-cleanup-intro-get-started/group/endpoint-visualizations

## Part of series
- PR 1/4 — intro + get started overlay (this PR)
- PR 2/4 — improved endpoint descriptions and response schemas
- PR 3/4 — request/response examples per endpoint
- PR 4/4 — schema cleanup

## Test plan
- [ ] `make api-docs-overlay` exits 0
- [ ] "Try it now" curl runs successfully against a local Kibana with
sample logs installed
- [ ] Tag description renders correctly in the preview link above

---------

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
(cherry picked from commit 6eacdb4)
@kibanamachine kibanamachine merged commit 35b4008 into elastic:9.4 Apr 14, 2026
19 checks passed
@elasticmachine
Copy link
Copy Markdown
Contributor

💛 Build succeeded, but was flaky

Failed CI Steps

Test Failures

  • [job] [logs] FTR Configs #195 / AgentBuilder Endpoints SML internal API POST /internal/agent_builder/sml/_attach attaches SML items and persists conversation attachment refs
  • [job] [logs] FTR Configs #112 / cases security and spaces enabled: basic Cases telemetry should return the correct total number of alerts attached to cases
  • [job] [logs] Scout: [ security / entity_store ] plugin / local-stateful-classic - Entity Store Logs Extraction with pagination (max 5 docs per page) - Should extract properly extract host with pagination

Metrics [docs]

✅ unchanged

cc @florent-leborgne

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport This PR is a backport of another PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants