Skip to content

Dashboard new endpoints documentation#1

Draft
raznar wants to merge 1 commit intobest_practices_demofrom
cursor/dashboard-new-endpoints-documentation-dd3c
Draft

Dashboard new endpoints documentation#1
raznar wants to merge 1 commit intobest_practices_demofrom
cursor/dashboard-new-endpoints-documentation-dd3c

Conversation

@raznar
Copy link
Owner

@raznar raznar commented Jan 29, 2026

What is this feature?

This PR adds comprehensive documentation for several existing but previously undocumented Dashboard HTTP API endpoints in dashboard.md.

Why do we need this feature?

To provide complete and accurate API documentation for developers and users who interact with Grafana's dashboard features programmatically, improving usability and reducing the learning curve.

Who is this feature for?

Developers, integrators, and advanced users who manage dashboards, permissions, versions, public sharing, and snapshots via the Grafana HTTP API.

Which issue(s) does this PR fix?:

Fixes #

Special notes for your reviewer:

Please check that:

  • It works as expected from a user's perspective.
  • If this is a pre-GA feature, it is behind a feature toggle.
  • The docs are updated, and if this is a notable improvement, it's added to our What's New doc.

This PR documents the following API endpoint categories:

  • Dashboard Permissions
  • Dashboard Versions and Restore
  • Dashboard Import
  • Public Dashboards
  • Dashboard Snapshots

Each endpoint includes request/response examples, authentication requirements, and error codes, following existing documentation patterns.


Open in Cursor Open in Web

Add comprehensive documentation for the following dashboard API endpoints:

- Dashboard Permissions (GET/POST /api/dashboards/uid/:uid/permissions)
- Dashboard Versions (GET versions list and specific version)
- Restore Dashboard Version (POST /api/dashboards/uid/:uid/restore)
- Import Dashboard (POST /api/dashboards/import)
- Public Dashboards (GET/POST/PATCH/DELETE)
- Dashboard Snapshots (create, get, delete, search, sharing options)

Documentation includes:
- Request/response examples
- Authentication requirements
- Required permissions with scopes
- Error codes and status messages
- JSON body schema descriptions

Co-authored-by: ryan <ryan@aznar.io>
@cursor
Copy link

cursor bot commented Jan 29, 2026

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

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.

2 participants