Skip to content

[Dashboards] Add programmatic creation docs and API examples#5770

Draft
florent-leborgne wants to merge 9 commits intomainfrom
add/dashboards-api-docs
Draft

[Dashboards] Add programmatic creation docs and API examples#5770
florent-leborgne wants to merge 9 commits intomainfrom
add/dashboards-api-docs

Conversation

@florent-leborgne
Copy link
Copy Markdown
Member

Summary

This PR adds documentation for creating Kibana dashboards and visualizations programmatically, as a companion to elastic/kibana#259842 (Visualizations API) and the pending Dashboards API Kibana PR.

New page: explore-analyze/dashboards/create-programmatically.md — covers the Dashboards API, the Lens Visualizations API, the kibana-dashboards agent skill, and the upcoming Agent Builder dashboard tools. All API content is gated at preview 9.4.

Updated pages:

  • explore-analyze/dashboards/building.md — adds a pointer to the new programmatic page
  • explore-analyze/dashboards/create-dashboard.md — adds a collapsible API dropdown after the agent-skill callout
  • explore-analyze/kibana-data-exploration-learning-tutorial.md — adds a forward link in Step 3 and a full API dropdown at the end of the step, so learners can discover the API without skipping the manual tutorial

Notes

  • All API examples use applies_to: stack: preview 9.4 / serverless: preview
  • API payloads were validated against Kibana main branch
  • The Agent Builder tools section references [Epic] Dashboards in chat - Tech Preview kibana#237795 (tech preview, dashboard tools coming in 9.4)
  • The kibana-dashboards agent skill is already linked from create-dashboard.md via the {agent-skill} directive; this PR adds a dedicated section in the new overview page

Test plan

  • Verify applies_to badges render correctly on all modified pages
  • Verify dropdown directives render and collapse correctly
  • Verify all links to API reference resolve
  • Verify toc.yml addition shows create-programmatically.md in the nav

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

✅ Vale Linting Results

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Dashboards API documentation to dashboards narrative docs

1 participant