Skip to content

Update from code changes: document custom roles as code#1008

Merged
rephus merged 1 commit into
mainfrom
mintlify/7a1052e2
Jul 15, 2026
Merged

Update from code changes: document custom roles as code#1008
rephus merged 1 commit into
mainfrom
mintlify/7a1052e2

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Summary

Document the new organization-scoped custom roles as code workflow, added in lightdash/lightdash#25520.

Changes

  • Added a "Custom roles as code" section to the dashboards-as-code guide covering the YAML contract (lightdash/custom-roles/<slug>.yml), download/upload lifecycle (create / update / no-change), org-admin permissions, and immutability of the role level.
  • Added a "Managing custom roles as code" section to the custom roles reference with a quick-start and format table, cross-linking to the guide.
  • Documented the new --organization flag on lightdash download and lightdash upload in the CLI reference, with examples.

Context

Custom roles are the first organization-scoped domain in content as code. The CLI's --organization mode switches download/upload away from project content and hits an org endpoint that requires an organization admin. Uploads are per-file and non-destructive — malformed files fail individually and no role is ever deleted.

@github-actions

github-actions Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

@mintlify

mintlify Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Jul 15, 2026, 12:45 AM

@mintlify mintlify Bot requested a review from rephus July 15, 2026 00:44
@rephus rephus merged commit 4e2fe15 into main Jul 15, 2026
6 checks passed
@rephus rephus deleted the mintlify/7a1052e2 branch July 15, 2026 09:33
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.

1 participant