No "Copilot Requests" permission in GitHub Apps despite the Copilot SDK documentation saying otherwise

[mokshadharma]

Warning - This might be a public repository, please be mindful of sharing sensitive data

Why are you seeing this issue?

This is a support escalation! You can find out more about expectations on communications and response times in the on-call docs. Thank you for doing your part to keep GitHub customers happy!

Severity

Note, for Sev1 issues always page the team first, using the PagerDuty information in the service catalog and the command .pager trigger N/A <reason>. Opening an issue for a Sev2 incident can come later (and can be done by the available Escalation Engineer).

• sev1 - Engineering must respond, when paged, within 1 business day
• sev2 - Engineering must respond to this issue within 2 business days
• sev3 - Engineering must respond to this issue within 2 business days

Service

copilot-sdk

Context

⚠️ Kindly provide all the requested information to ensure a prompt and efficient response. ⚠️

GitHub Support Plan

• Top 20
• Premium Plus
• Premium
• Enterprise
• Free/Pro/Team

GitHub Product(s) Impacted (check appropriate boxes and provide GHES version if applicable)

• GitHub.com (including GHEC)
• GitHub Enterprise Server.
  • Running version: x.y.z
  • Recently upgraded from version: x.y.z (upgrade date: yyyy-mm-dd)
• Proxima (ghe.com)
  • Customer tenant: -

Customer Impact

If applicable, list the impacted entities:

• Enterprise: -
• Organization: -
• Repository: -
• User: -

Zendesk Ticket(s), support bundles, and other relevant Issues and links

• 4650604

Issue

Customer reports that while the Other services and CI systems section of the Server-to-server authentication page of the Copilot SDK documentation says you should:

Create a GitHub App with the Copilot Requests repository permission set to Read & write.

But when creating a GitHub App there doesn't seem to be any such repository permission in the UI.

To Reproduce

Steps to reproduce the behavior:

1. Go to ...
2. Click on ...
3. Scroll down to ...
4. See error

Expected behavior

The documented Read & write Copilot Requests repository permission should exist.

Screenshots

N/A

Additional context

I have tried creating a GitHub App myself and did not see this permission.

cc:

@patniko

Support Squad(s): @github/support-squad-ecosystem

[github-actions]

Documentation Gap Identified

Thanks for the escalation! This is a documentation accuracy issue.

Summary

The Server-to-server authentication page instructs users to create a GitHub App with a "Copilot Requests" repository permission set to Read & write, but this permission does not appear to exist in the GitHub App creation UI.

Affected Documentation

• Page: docs.github.com/en/copilot/how-tos/copilot-sdk/auth/server-to-server-tokens
• Section: Other services and CI systems

What Needs to Be Fixed

The documentation should be updated to one of the following:

1. Correct the permission name — if "Copilot Requests" was renamed or replaced by a different permission (e.g., it may now be under a different category or have a different label), update the docs to reflect the current permission name and location in the GitHub App settings UI.
2. Remove or clarify — if this permission is no longer required or the setup flow has changed, update the instructions accordingly with accurate steps.

The engineering team should verify the current correct permission(s) required for GitHub App-based server-to-server authentication with the Copilot SDK and update the docs source accordingly.

Generated by Documentation Handler for #2304 · sonnet46 16.9 AIC · ⌖ 5.07 AIC · ⊞ 5.4K · ◷

[mokshadharma]

There is a thread about this issue in the #copilot-sdk channel here.