Permission & Access Errors

## Permission & Access Errors

Permission and access errors usually occur when SyntaxValid does not have the required authorization to analyze a repository.

This page explains common causes and how to resolve them.

---

## Common symptoms

You may encounter permission issues if:

- A repository does not appear in the project list

- An analysis fails immediately

- GitHub pull request checks do not run

- Error messages mention access, authorization, or permissions

These issues are typically configuration-related.

---

## GitHub App installation scope

The GitHub App must be installed with access to the correct repositories.

Check that:

- The app is installed on the correct organization or user account

- Repository access includes the target repository

- The installation scope was not limited unintentionally

Updating installation permissions often resolves the issue.

---

## Repository visibility

SyntaxValid can only access repositories it is authorized to read.

Ensure that:

- The repository is not private without access

- Organization-level restrictions allow third-party apps

- Repository access has not been revoked

Visibility changes take effect immediately.

---

## Insufficient permissions

Common missing permissions include:

- Read access to repository contents

- Read access to pull requests

- Status reporting permissions

Without these, analyses cannot start or report results.

---

## Token and authorization errors

If authentication fails:

- Re-authenticate with GitHub

- Reinstall the GitHub App if necessary

- Ensure your account still has access to the repository

Expired or revoked tokens can cause access failures.

---

## Organization-level restrictions

Some organizations restrict third-party applications.

Verify:

- App installation policies

- Required approval steps

- Security or compliance restrictions

Administrator approval may be required.

---

## How to resolve access issues

Follow these steps:

1. Confirm GitHub App installation

2. Verify repository access scope

3. Reconnect your GitHub account

4. Re-run analysis after confirmation

Most issues are resolved at this stage.

---

## What SyntaxValid does not do

SyntaxValid does not:

- Escalate permissions automatically

- Access repositories without explicit authorization

- Bypass organization security policies

All access is explicit and revocable.

---

## When to contact support

Contact support if:

- Access issues persist after reinstalling the app

- Errors occur across multiple repositories

- You suspect a platform-level issue

Include the repository name and error message if possible.

---

## Next steps

- Analysis configuration

- GitHub App integration

- General FAQ