Gitlab

Configuration

GitLab source connector integrates with the GitLab REST API to extract data.

Connects to your GitLab projects.

It supports syncing projects, users, repository files, issues, and merge requests with configurable filtering options for branches and file types.

Explore the Gitlab connector implementation

This connector uses OAuth 2.0 authentication. You can connect through the Airweave UI or API using the OAuth flow.

Supported authentication methods:

The following configuration options are available for this connector:

Configuration Parameters

GitLab configuration schema.

project_id

str

Specific project ID to sync (e.g., ‘12345’). If empty, syncs all accessible projects.

branch

str

Specific branch to sync (e.g., ‘main’, ‘master’). If empty, uses the default branch.

The following data models are available for this connector:

Schema for GitLab project (repository) entity.

Field	Type	Description
name	str	Project name
path	str	Project path
path_with_namespace	str	Full path with namespace
description	Optional[str]	Project description
default_branch	Optional[str]	Default branch of the repository
created_at	datetime	Creation timestamp
last_activity_at	Optional[datetime]	Last activity timestamp
visibility	str	Project visibility level
topics	List[str]	Project topics/tags
namespace	Dict[str, Any]	Project namespace information
star_count	int	Number of stars
forks_count	int	Number of forks
open_issues_count	int	Number of open issues
archived	bool	Whether the project is archived
empty_repo	bool	Whether the repository is empty

Schema for GitLab user entity.

Schema for GitLab directory entity.

Field	Type	Description
path	str	Path of the directory within the repository
project_id	str	ID of the project containing this directory
project_path	str	Path of the project

Schema for GitLab code file entity.

Field	Type	Description
blob_id	str	Blob ID of the file content
path	str	Path of the file within the repository
project_id	str	ID of the project
project_path	str	Path of the project

Schema for GitLab issue entity.

Field	Type	Description
title	str	Issue title
description	Optional[str]	Issue description
state	str	Issue state (opened, closed)
created_at	datetime	Issue creation timestamp
updated_at	datetime	Issue last update timestamp
closed_at	Optional[datetime]	Issue close timestamp
labels	List[str]	Issue labels
author	Dict[str, Any]	Issue author information
assignees	List[Dict[str, Any]]	Issue assignees
milestone	Optional[Dict[str, Any]]	Issue milestone
project_id	str	ID of the project
iid	int	Internal issue ID
web_url	str	Web URL to the issue
user_notes_count	int	Number of user notes/comments
upvotes	int	Number of upvotes
downvotes	int	Number of downvotes

Schema for GitLab merge request entity.

Field	Type	Description
title	str	Merge request title
description	Optional[str]	Merge request description
state	str	Merge request state (opened, closed, merged)
created_at	datetime	Merge request creation timestamp
updated_at	datetime	Merge request last update timestamp
merged_at	Optional[datetime]	Merge request merge timestamp
closed_at	Optional[datetime]	Merge request close timestamp
labels	List[str]	Merge request labels
author	Dict[str, Any]	Merge request author information
assignees	List[Dict[str, Any]]	Merge request assignees
reviewers	List[Dict[str, Any]]	Merge request reviewers
source_branch	str	Source branch name
target_branch	str	Target branch name
milestone	Optional[Dict[str, Any]]	Merge request milestone
project_id	str	ID of the project
iid	int	Internal merge request ID
web_url	str	Web URL to the merge request
merge_status	str	Merge status (can_be_merged, cannot_be_merged)
draft	bool	Whether the merge request is a draft
work_in_progress	bool	Whether the merge request is work in progress
upvotes	int	Number of upvotes
downvotes	int	Number of downvotes
user_notes_count	int	Number of user notes/comments