Introduction
Connect GitLab to Sana to search and manage issues, epics, branches, and commits. Stay on top of your development work with context from your connected apps. In summary, the connector has the following key characteristics:
Category: Engineering
Connector type: Real-time
Auth type: OAuth
Hosting type: Managed
Capabilities
This connector is able to do the following:
Capability |
Search issues |
Create issues |
Update issues |
Manage epics |
List groups |
List branches |
Create branches |
List commits |
Tools
While the capabilities above describe what the connector can do at a high level, the underlying tools show exactly which operations the agent can use when you ask Sana about GitLab. In practice, the agent may call one or more tools to achieve a single capability.
Tool |
Create branch |
Create epic |
Create issue |
Get issue |
Get repo branch |
List commits |
List groups |
List repo branches |
Search issues |
Update epic |
Update issue |
Scope and permissions
This connector uses OAuth. When you connect your account, you will need to sign into your account and grant the required permissions:
Scope | Purpose |
api | Full access to GitLab API (all resources this user can reach) |
read_user | Read basic user profile and groups/memberships |
read_repository | Read code, branches, tags, and repo metadata |
write_repository | Push commits, create branches, tags, and MR-related changes |
read_registry | Pull/view images and metadata from GitLab Container Registry |
sudo | Act on behalf of other users with elevated admin powers |
openid | Use GitLab as an OpenID Connect identity provider |
profile | Read standard OpenID profile info (name, username, avatar) |
Read verified email address(es) for the user |
Set up instructions
Prerequisites:
Your Sana workspace admin has enabled this integration – if the workspace admin has disabled the integration it won't appear in the list of available integrations.
Step 1: Go to the integrations page in Sana
In Sana, click on ... More in the sidebar, then select Integrations
Step 2: Find GitLab in the list of available integrations
Scroll to the Available integrations section and locate GitLab.
Step 3: Connect the integration
Click the integration card and select "Connect just for me", this will open a pop-up powered by Pipedream. Follow the steps in the pop-up to complete the set-up.
Step 4: Sign in to GitLab and approve the requested scopes
You'll be redirected to GitLab to go through their OAuth flow. Sign in and approve the scopes Sana needs to operate the connector.
Step 5: Complete the set up
You've successfully connected your GitLab account. Click Continue to complete the setup and start using the connector.
Known limitations
Files: The connector cannot read, create, or update files.