What is "contents: write" permission in GitHub workflow?

Question

Recently I've faced an issue https://github.com/kkohtaka/gh-actions-pr-size/issues/9 that has a possible solution as adding contents: write permission to my job:

permissions:
   contents: write
   ...

I've tried to find an explanation for it in https://docs.github.com/en/actions/using-jobs/assigning-permissions-to-jobs but found only supported values like contents: read|write|none.

What is contents: write permission in GitHub workflow? What does it give?

Answer 1

The token permissions are based on the GitHub App permission model.

You can refer to the overview for the GitHub App contents permission.