Thanks to visit codestin.com
Credit goes to github.com

Skip to content

The permissions: workflows: option is currently undocumented #41140

@simonw

Description

@simonw

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:

```yaml
permissions:
actions: read|write|none{% ifversion artifact-attestations %}
attestations: read|write|none{% endif %}
checks: read|write|none
contents: read|write|none
deployments: read|write|none{% ifversion fpt or ghec %}
id-token: write|none{% endif %}
issues: read|write|none{% ifversion not ghes %}
models: read|none{% endif %}
discussions: read|write|none
packages: read|write|none
pages: read|write|none
pull-requests: read|write|none{% ifversion projects-v1 %}
repository-projects: read|write|none{% endif %}
security-events: read|write|none
statuses: read|write|none
```

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentThis issue or pull request belongs to the Docs Content teamtriageDo not begin working on this issue until triaged by the team

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions