Request: Document PAT permissions requirements for machine accounts

[joshlf]

I'm following the steps described here using this machine account to submit PRs to zerocopy. My current attempt is here, with the latest GitHub Actions failure here.

It'd be awesome if those docs could explain what permissions a PAT needs in order for this flow to succeed. I'm not positive, but my guess is that I'm not granting the PAT the right permissions in this case, which is the cause of the failure.

[peter-evans]

Hi @joshlf

I think what you are experiencing is the same as this issue: #1791

I guess you are trying to use a fine grained access token. They are still in beta and don't work for all GitHub APIs yet. Please use a classic PAT with repo scope, as described in the above linked issue. You also need 'workflow' scope if the generated PR will ever contain changes to the .github/workflows directory.

[joshlf]

That worked perfectly, thanks for the help!