The permissions: workflows: option is currently undocumented

[simonw]

Code of Conduct

• [x] I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax#defining-access-for-the-github_token-scopes and possibly others.

What part(s) of the article would you like to see updated?

The section in this fragment:

https://github.com/github/docs/blob/575894c16f97aa7d049a45628d5c78dd8424ef10/data/reusables/actions/github-token-available-permissions.md#L3-L20

It needs to include this:

permissions:
  workflows: write

This permission allows the token to push changes to files in the .github/workflows folder.

Additional information

I'm sure there are other places that need to talk about this feature.

[Sharra-writes]

@simonw Thanks for opening an issue and PR! I'm actively trying to get through my backlog of Actions questions, so I'll add this one to the queue and let you know when I have an answer from that team.

[github-actions[bot]]

A stale label has been added to this issue, because it has been open for 30 days with no activity. If you think this issue should remain open, please add a new comment.