Gitlab

Creating Gitlab Access Tokens for Upriver

Upriver requires limited, read-only Gitlab 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.

---

Generating access tokens

This guide explains how to connect GitLab to Upriver using either a Personal Access Token or a Group Access Token.

💡 A Group Access Token is recommended when integrating on behalf of a team or organization. It allows controlled, revocable access at the group level and does not rely on any single user’s account.

Generating an access token Access Token

1. Go to the relevant settings page:

   1. For Group Access Tokens: Group → Settings → Access Tokens

   2. For Personal Access Tokens: User → Settings → Access Tokens

2. Create a new token:

   • Name: upriver-access

   • Expiration: Set as needed

   • Scopes (required):

     • read_api

     • read_repository

     • read_registry

     • read_virtual_registry

     
3. Click Create token

4. Copy the token safely

⚠️ Important: The token value will be displayed only once. Copy it immediately and store it securely. If you lose it, you’ll need to generate a new token.