Skip to content

Document copilot-requests in the Actions permissions reference - #45904

Open
kjanat wants to merge 1 commit into
github:mainfrom
kjanat:docs/copilot-requests-permission
Open

kjanat wants to merge 1 commit into
github:mainfrom
kjanat:docs/copilot-requests-permission

Conversation

@kjanat

@kjanat kjanat commented Sep 15, 2026

Copy link
Copy Markdown

Why

Using Copilot CLI in GitHub Actions with GITHUB_TOKEN requires copilot-requests: write, but the Actions workflow syntax permission list and descriptions omit it. The workflow-parser schema defines it as write-or-none.

What's being changed

Add copilot-requests: write|none and a description linking to the existing setup instructions, including the organization billing-policy prerequisite. Gate both entries with the existing copilot feature, matching the linked article's availability.

Validation

Checked the scope/type against the schema, the prerequisite against the linked how-to, and the feature flag against data/features/copilot.yml. git diff --check passes. Content lint and render tests could not start in the sparse checkout: tsx and vitest are not installed.

  • Technical statements checked against the existing documentation and schema.
  • Change follows existing reusable-table and feature-versioning patterns.
  • CI checks and review environment.

@welcome

welcome Bot commented Sep 15, 2026

Copy link
Copy Markdown

Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

@github-actions github-actions Bot added the triage Do not begin working on this issue until triaged by the team label Sep 15, 2026
@github-actions

Copy link
Copy Markdown
Contributor

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
actions/reference/workflows-and-actions/workflow-syntax.md fpt
ghec
ghes@ 3.22 3.21 3.20 3.19 3.18 3.17
fpt
ghec
ghes@ 3.22 3.21 3.20 3.19 3.18 3.17
from reusable

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No unresolved review issues remain.

Pull request overview

Documents the copilot-requests permission in the Actions permissions reference.

Changes:

  • Adds copilot-requests: write|none to available permissions.
  • Adds feature-gated usage guidance and billing prerequisites.
File summaries
File Reviewed change
data/reusables/actions/github-token-scope-descriptions.md Adds the permission description and prerequisites.
data/reusables/actions/github-token-available-permissions.md Adds the supported permission values.
Review details
  • Files reviewed: 2/2 changed files
  • Comments generated: 0
  • Review effort level: Lite (auto)

Note

Copilot is running an experiment and ran this review at Lite.


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

triage Do not begin working on this issue until triaged by the team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants