GitLab Integration

Use GitLab integration to let Dawn discover projects on gitlab.com and read repository, issue, and merge request context.

Before you start

• A GitLab account with access to the projects Dawn should use.
• A GitLab personal access token.
• The GitLab SaaS base URL, https://gitlab.com.

The current Dawn GitLab provider supports GitLab SaaS only. Self-managed GitLab instances are not currently supported in this flow.

Create the personal access token

1. Create a GitLab personal access token for the account Dawn should use.
2. Grant read access to the projects Dawn should discover.
3. Use read_api and read_repository as the starting scopes.
4. Copy the token and store it safely.

Connect GitLab in Dawn

1. Open Integrations in Dawn and click Add connection.
2. Choose GitLab.
3. Paste the token into Access token.
4. Leave Base URL set to https://gitlab.com.
5. Click Connect.
6. Review the discovered projects and link the sources you want available in the workspace.
7. Assign those linked sources to the agents that should use them.

What Dawn discovers

For each discovered GitLab project, Dawn creates repository, issue, and pull request sources. The pull request source maps to GitLab merge requests.

Troubleshooting

• Validation fails for the base URL: use https://gitlab.com. The current provider is SaaS only.
• Projects are missing: the token account likely does not have visibility into those groups or projects.
• Connection test fails: confirm the token is active and includes read_api and read_repository.

List GitLab-linked sources and verify project read access.

Check merge request and issue retrieval for linked GitLab sources.