grafana/docs/sources/as-code/observability-as-code/git-sync/git-sync-setup
Roberto Jiménez Sánchez b5f55eebeb
Docs: Add Administration permission requirement for GitHub Git Sync (#119513)
* Docs: Add Administration permission requirement for GitHub Git Sync

When using the write workflow with GitHub repositories, Git Sync
validates that branch protection rules don't block direct pushes.
This validation requires the Administration read permission.

Without this permission, users receive a 403 Forbidden error when
testing repository configuration. Git Sync now handles this gracefully
by skipping the branch protection check when admin permissions are
unavailable.

Updated documentation:
- Added Administration read-only permission to GitHub App setup
- Added Administration read-only permission to PAT setup
- Added explanatory note about why it's needed

This permission is optional - if not provided, branch protection
validation is skipped and users will discover any issues when they
actually push to the repository.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* Update Administration permission description to be more general

Instead of specifically mentioning 'write workflow', explain that:
- It enables validation of branch protection rules when users can push directly
- It may be used in the future for other repository settings checks
- This makes the permission requirement more future-proof

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-03-04 16:32:36 +00:00
..
_index.md Docs: Add Administration permission requirement for GitHub Git Sync (#119513) 2026-03-04 16:32:36 +00:00
set-up-before.md Docs: Add Administration permission requirement for GitHub Git Sync (#119513) 2026-03-04 16:32:36 +00:00
set-up-code.md Docs: GS - New Git providers (#118354) 2026-02-23 12:42:16 +01:00
set-up-extend.md Docs: GS - New Git providers (#118354) 2026-02-23 12:42:16 +01:00