Document required token scopes in README #66

Closed
opened 2026-05-11 06:38:19 +00:00 by rodin · 0 comments
Owner

The reviewer-token needs specific Gitea scopes to function properly:

Required scopes:

  • write:issue - to post reviews
  • write:repository - to read PR diffs
  • read:user - to check if PR author matches reviewer (skip self-reviews)

Without read:user, the bot logs:

level=WARN msg="could not determine authenticated user for reviewer self-request" error="...required=[read:user], token scope=write:issue,write:repository..."

The README should document these required scopes so users know to set them when creating tokens.

The `reviewer-token` needs specific Gitea scopes to function properly: **Required scopes:** - `write:issue` - to post reviews - `write:repository` - to read PR diffs - `read:user` - to check if PR author matches reviewer (skip self-reviews) Without `read:user`, the bot logs: ``` level=WARN msg="could not determine authenticated user for reviewer self-request" error="...required=[read:user], token scope=write:issue,write:repository..." ``` The README should document these required scopes so users know to set them when creating tokens.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: rodin/review-bot#66