Permissions troubleshooting
Use this when project role, reviewer assignment, or approval ownership prevents someone from completing the intended work.
Symptom
A user can access Teammately but cannot open the expected Project, or an expert reports no tasks available after opening their Contribution link. These symptoms belong to different owning surfaces.
Likely causes
- The user lacks the required Project permission through a direct grant, workspace group, or workspace role.
- The Contribution was requested for a different recipient.
- The Contribution exists but its next Task or Checkpoint is not ready.
- The current IP is blocked before Project membership is evaluated.
Diagnostic checks
- Check direct grants in Project Settings → Project Members, the user's workspace-group membership, and the group's permission for the intended Project. Absence from the direct member list alone does not establish lack of access. Inspect workspace status and role in Admin → Directory → Members as well.
- Open the Contribution from the sender-side Expert Contributions workspace and verify its recipient and status.
- Check whether the expert has an executable Task or Checkpoint, not merely whether the Contribution exists.
- If Access Restricted is visible, resolve the IP allowlist first.
Fix
- Add the correct individual workspace user under Project Settings → Project Members when direct Project membership is missing.
- If access is intended through a workspace group, confirm both the user's membership in that group and its permission for the intended Project.
- Correct the Contribution recipient through the owning Contribution workflow when the request went to the wrong person.
- Resolve lifecycle or readiness problems in Expert Contributions when access succeeds but no Task can be entered.
- Do not infer a permission from a role label or edit governed artifacts merely to make a control appear.
Prevention
- Separate reviewer access from approval authority in review setup.
- Check assignments before launching a review session.
- Use a small pilot Contribution before assigning a larger specialist cohort.
- Keep project membership changes visible to review owners.
