What You'll Need Credential What it is Token Personal access token with API scope Base URL https://gitlab.com or your self-hosted GitLab URL
Overview Connect Parable to GitLab for comprehensive DevOps and repository data.
Code & MRs Projects, merge requests, commits
Issues & Planning Issues, milestones, labels
Prerequisites Setup access in . These steps require , or a colleague with equivalent permissions who can create credentials for you.If that is not you, ask your administrator.
Owner or Maintainer role in the group/projectFor group-level access, group owner permissions
Setup Guide
Access User Settings
Log in to GitLab (gitlab.com or your instance)
Click your avatar → Preferences
Navigate to Access Tokens in the sidebar
Create Personal Access Token
Click Add new token
Fill in:
Field Value Token name Parable IntegrationExpiration date 1 year (or per policy)
Select Scopes
Enable these scopes: Scope Purpose apiFull API access read_apiRead-only API (alternative) read_userRead user information read_repositoryRead repository contents
For read-only integration, use read_api instead of api.
Create and Copy Token
Click Create personal access token
Copy the token immediately
Copy your now! This is the only time it will be displayed. Store it in a secure password manager before closing this page.
Enter values in the form
Token and GitLab URL : Paste your personal access token and your GitLab instance base URL.Click Save & test connection .
Verify Your Setup Test Authentication
List Projects
curl -H "PRIVATE-TOKEN: YOUR_TOKEN" \ "https://gitlab.com/api/v4/user"
Success! If you received a 200 OK response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.
Rate Limits: enforces rate limits of .Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.
Troubleshooting Error Meaning Solution 401 UnauthorizedInvalid token Verify token is correct and not expired 403 ForbiddenInsufficient scope Add required scope and regenerate 404 Not FoundNo access to resource Check user has project/group membership 429 Rate LimitedToo many requests Implement backoff
Token expired GitLab PATs have expiration dates. Generate a new token with a longer expiration. Can’t access group projects Ensure your GitLab user has at least Reporter access to the group. Additional Resources
GitLab API Official API documentation
Token Types Access token guide
