Document copilot-requests in the Actions permissions reference

[kjanat]

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]

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]

How to review these changes 👓

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

• Spin up a codespace
• Set up a local development environment

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]

🟢 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.