claude-memory/graph/problems/gitea-api-403-forbidden-insufficient-token-scopes-1052e9.md
Cal Corum b140d4d82a migrate: 313 memories from MemoryGraph
- 313 new markdown files created
- 30 relationships embedded
- 313 entries indexed
- State initialized with usage data
2026-02-13 11:11:48 -06:00

1.3 KiB

id type title tags importance confidence created updated relations
1052e91d-58ed-4308-87e8-e01d1143a146 problem Gitea API 403 Forbidden - insufficient token scopes
gitea
api
authentication
403
token
scopes
troubleshooting
homelab
0.7 0.8 2026-02-04T05:10:33.498045+00:00 2026-02-04T05:10:33.498045+00:00
target type direction strength
13c13f73-fe1d-4227-a3d1-45498f8d3d3b REQUIRES incoming 0.5

PROBLEM: Gitea API returned 403 Forbidden with message 'token does not have at least one of required scope(s): [read:user]'

ROOT CAUSE: API token was created without proper scopes/permissions selected in Gitea web UI.

SOLUTION: When creating Gitea API tokens:

  1. Go to Settings > Applications > Generate New Token
  2. MUST select appropriate scopes:
    • 'read:user' - required for user info endpoints
    • 'write:repository' or 'repo' - required for branch protection
    • Or select 'repo' (full repository access) which includes both

TESTING: Verify token scopes with: curl -H 'Authorization: token YOUR_TOKEN' https://git.manticorum.com/api/v1/user

ERROR PATTERN: Look for 'does not have at least one of required scope(s)' in 403 responses.

RELATED: For authenticated user's repos, use /api/v1/user/repos instead of /api/v1/users/{username}/repos