Github
Github integration guide for Upriver
Creating GitHub Fine-Grained Personal Access Tokens for Upriver
Upriver requires limited, read-only GitHub access so the agent can analyze your codebase and provide accurate insights related to your data pipelines, transformations, and operational logic. By reading the relevant repository contents, Upriver can help identify issues, debug pipeline behavior, and enhance end-to-end understanding of how your code generates and processes data. The token you create grants only the minimal permissions needed for this analysis.
1. Access Your Personal Settings
In the upper-right corner of any GitHub page, click your profile picture.
Select Settings from the dropdown menu.
2. Navigate to Developer Settings
In the left sidebar, click Developer settings.
Under Personal access tokens, select Fine-grained tokens.
Tip: You can also go directly to the Generate new fine-grained personal access token page.
3. Generate a New Token
Click Generate new token.
4. Configure the Token
Token name: Use a descriptive name (e.g.,
upriver-agent-access).Expiration: Choose an expiration date. Shorter durations provide better security.
Description (optional): Add a brief note about the token's purpose.
Resource owner: Select the organization containing the repositories Upriver should analyze.
5. Set Repository Access and Permissions
Repository Access
Select Only select repositories (recommended).
Choose only the repositories that you want Upriver to access.
Permissions
Under Permissions, add:
Contents
Read-only
Metadata
Read-only
These are the only permissions Upriver requires.
6. Finalize the Token Creation
Click Generate token.
⚠️ Important: The token value (beginning with
github_pat_...) will be displayed only once. Copy it immediately and store it securely. If you lose it, you’ll need to generate a new token.
Last updated