Development

GitLab Integration

Work with projects — list projects, issues, and merge requests, create issues and merge requests, and comment (writes require approval). Self-hosted supported.

Capabilities

This integration enables workers to:

  • List projects
  • List issues
  • List merge requests
  • Create issues (approval-gated)
  • Create merge requests (approval-gated)
  • Comment on issues and merge requests (approval-gated)

Setup

Follow these steps to connect GitLab:

  1. Create a GitLab Personal Access Token with the 'api' scope (Preferences → Access Tokens)
  2. Navigate to Integrations and click 'Add Connection'
  3. Select GitLab and paste your Personal Access Token
  4. For self-hosted GitLab, also provide your instance base URL
  5. Assign your security/access/operations workers to use it

Official links

Security

  • The Personal Access Token is encrypted at rest (AES-256-GCM)
  • The 'api' scope inherits the issuing user's access — use a least-privilege account
  • Creating issues, merge requests, and comments require human approval

Credential Storage

All integration credentials are encrypted at rest using AES-256-GCM encryption. OAuth tokens are automatically refreshed when needed.

Supported Roles

The following roles can use this integration by default:

Related Documentation