Troubleshooting

401 invalid_token

Corpole refused the agent's credentials. The token is revoked or expired, the project is not active, or its owner can no longer read the project.

For: Team developer, Solo builder

Why it happens

  • The agent token was revoked, or its expiry date has passed.
  • The project is not active (for example, archived).
  • The token's owner can no longer read the project: their role or project access was removed. A token never carries more than its owner's permissions.
  • An OAuth connection was disconnected, or its refresh token was reused and the connection was revoked for safety.

Fix it

  1. Using OAuth in Claude Code: run /mcp, select corpole and choose Authenticate.
  2. Using a token: open Agents → Agent tokens in the project, create a new personal token and replace the old one where your agent reads it (CORPOLE_TOKEN or ~/.config/corpole/token).
  3. If the token belongs to someone who left the project, ask a person with the integrations permission to create a service token for CI.