GitLab
You can integrate your TeamRetro team with your GitLab account, and automatically publish action items as GitLab issues.
To configure this integration you must be a TeamRetro Team Administrator or an Account Administrator.

Creating an Access Token in GitLab
-
To create an access token in GitLab, click on your icon at the top right followed by PREFERENCES.

-
Click on the ACCESS TOKENS tab on the left navigation bar.

-
Give your Access Token a name (e.g. TeamRetro or similar) and check the API scope option underneath the SELECT SCOPES heading.

-
Click on CREATE PERSONAL ACCESS TOKEN at the bottom and one will be created for you. Be sure you keep record of it so it isn't lost.

Configure in TeamRetro
- Sign in to your TeamRetro account.
-
On the TEAM —> SETTINGS —> INTEGRATIONS screen, click on CONNECT next to GitLab.


-
You will then have the option to choose between the connection type based on your needs.

-
Proceed to enter your Access Token (and the Server URL for GitLab Self Managed connection) that you had created on your account and click on the arrow '->'. If you don't have one, then follow the steps under the 'Creating an Access Token' heading above.


-
If that succeeds, you'll be prompted to select the project you would like to publish your action items to.

-
Upon a successful connection, you can test the integration by publishing an action item as a GitLab issue


-
Click on SAVE CHANGES and you will see that the connection was successful back on the integrations pages.

Testing your integration
- Back on your team —> HOME screen, click the publish icon and you will see PUBLISH TO GITLAB as an option. You can also publish all action items at once.
- After selecting, TeamRetro will create a new Issue in GitLab and display the corresponding Issue ID on the card.



GitLab APIs Used
| Purpose | GitLab edition |
|
Retrieve version information for this GitLab instance. Responds 200 OK for authenticated users. We use this endpoint to test connectivity. |
/api/v4/version (GET) |
| Get a list of all visible projects for the authenticated user, for GitLab Project Fields | /api/v4/projects (GET) |
|
Get a list of GitLab User query by email address. This endpoint is used to get users that should be assigned to the issue / published action item |
/api/v4/users (GET) |
| Create GitLab issue & test integration | /api/v4/projects/[Project ID]/issues (POST) |
| Delete GitLab issue | /api/v4/projects/[Project ID]/issues/[Issue ID] (DELETE) |












