Skip to content

docs(github): mirror all app permissions and events to GHE setup#18830

Draft
alexsohn1126 wants to merge 1 commit into
masterfrom
alexsohn/keep-ghe-up-to-date
Draft

docs(github): mirror all app permissions and events to GHE setup#18830
alexsohn1126 wants to merge 1 commit into
masterfrom
alexsohn/keep-ghe-up-to-date

Conversation

@alexsohn1126

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Mirrors every permission and event from the Sentry GitHub App into the Installing GitHub Enterprise setup instructions, so GitHub Enterprise installs support the same features as github.com installs. Verified against the live app config via gh api /apps/sentry.

Since the GHE app is created and owned by the customer, its documented config had drifted from the hosted app.

Permissions

  • Fix Commit Statuses, documented as "No Access" but the app requires read & write
  • Add Actions (read & write), Checks (read & write), Code Quality (read-only), Code scanning alerts (read-only), Metadata (read-only), Webhooks (read & write), and Email addresses (read-only)

Events

  • Add check_run, check_suite, pull_request_review, and pull_request_review_comment

Docs note

  • Add an Alert explaining that this app is customer-owned, that its permissions and events mirror the github.com app, and that it should be updated when Sentry adds new ones

Open questions for the integrations team

  • Do Seer agent features (Autofix, AI Code Review) actually run against GitHub Enterprise Server installs? If not, the Seer permissions (Actions, Code Quality, Code scanning alerts) may not belong here.
  • Do the code_quality and security_events permission scopes exist on the minimum GHES version we support? They may not appear in the App settings UI on older versions.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

🤖 Generated with Claude Code

The GitHub Enterprise section describes a GitHub App that customers
create themselves, and its permissions and events had drifted from the
Sentry GitHub App used for github.com installs (verified via
`gh api /apps/sentry`).

Mirror the full set so GitHub Enterprise installs support the same
features:

- Fix Commit Statuses, which was documented as "No Access" but requires
  read & write
- Add the Actions, Checks, Code Quality, Code scanning alerts, Metadata,
  Webhooks, and Email addresses permissions
- Add the check_run, check_suite, pull_request_review, and
  pull_request_review_comment events
- Note that this app is customer-owned and should be kept in sync with
  the permissions documented for the github.com app

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview Jul 24, 2026 8:34pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Jul 24, 2026 8:34pm

Request Review

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