# Gitlab Your Toolhouse AI Worker can connect to Gitlab using 58 specialized tools. ## Auth Connection This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=gitlab). ## Tools (58) ### `Gitlab Archive Project` Integration name: **GITLAB\_ARCHIVE\_PROJECT** Tool to archive a project. Use when you need to mark a project read-only after finishing active development. Call after confirming no further changes are required. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ---- | :------: | ------- | ----------------------------------------------------- | | `id` | — | ✅ | `"5"` | The ID or URL-encoded path of the project to archive. | *** ### `Gitlab Create Group` Integration name: **GITLAB\_CREATE\_GROUP** Tool to create a new group in GitLab. Use when you need to establish a new group for projects or collaboration. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------------------ | ------- | :------: | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"My New Group"` | The name of the group. | | `path` | string | ✅ | `"my-new-group"` | The path of the group. | | `avatar` | string | | — | Image file for avatar of the group. | | `parent_id` | integer | | — | The parent group ID for creating nested group. | | `visibility` | string | | — | The group’s visibility. | | `description` | string | | — | The group’s description. | | `lfs_enabled` | boolean | | — | Enable/disable Large File Storage (LFS) for the projects in this group. | | `default_branch` | string | | — | The default branch name for group’s projects. | | `emails_enabled` | boolean | | — | Enable email notifications. | | `membership_lock` | boolean | | — | Users cannot be added to projects in this group. Premium and Ultimate only. | | `organization_id` | integer | | — | The organization ID for the group. | | `duo_availability` | string | | — | Duo availability setting. Note: In the UI, never\_on is displayed as "Always Off". | | `mentions_disabled` | boolean | | — | Disable the capability of a group from getting mentioned. | | `wiki_access_level` | string | | — | The wiki access level. Premium and Ultimate only. | | `auto_devops_enabled` | boolean | | — | Default to Auto DevOps pipeline for all projects within this group. | | `share_with_group_lock` | boolean | | — | Prevent sharing a project with another group within this group. | | `project_creation_level` | string | | — | Determine if developers can create projects in the group. | | `request_access_enabled` | boolean | | — | Allow users to request member access. | | `subgroup_creation_level` | string | | — | Allowed to create subgroups. | | `two_factor_grace_period` | integer | | — | Time before Two-factor authentication is enforced (in hours). | | `enabled_git_access_protocol` | string | | — | Enabled protocols for Git access. | | `experiment_features_enabled` | boolean | | — | Enable experiment features for this group. | | `shared_runners_minutes_limit` | integer | | — | Can be set by administrators only. Maximum number of monthly compute minutes for this group. Can be nil (default; inherit system default), 0 (unlimited), or > 0. GitLab Self-Managed, Premium and Ultimate only. | | `require_two_factor_authentication` | boolean | | — | Require all users in this group to set up two-factor authentication. | | `default_branch_protection_defaults` | object | | — | Options for default\_branch\_protection\_defaults. E.g. {"allowed\_to\_push": \[{"access\_level":40}], "allow\_force\_push": False, "allowed\_to\_merge": \[{"access\_level":40}], "developer\_can\_initial\_push": False} | | `extra_shared_runners_minutes_limit` | integer | | — | Can be set by administrators only. Additional compute minutes for this group. GitLab Self-Managed, Premium and Ultimate only. | *** ### `Gitlab Create Project` Integration name: **GITLAB\_CREATE\_PROJECT** Tool to create a new project in GitLab. Implements POST /projects endpoint. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------------- | ------- | :------: | ------------------ | ------------------------------------------------------------------- | | `name` | string | ✅ | `"My New Project"` | The name of the project. | | `path` | string | ✅ | `"my-new-project"` | The path or URL-friendly name for the project. | | `visibility` | string | | `"private"` | Project visibility. | | `description` | string | | — | Project description. | | `namespace_id` | integer | | — | The namespace (group or user ID) under which to create the project. | | `wiki_enabled` | boolean | | — | Enable wiki feature. | | `default_branch` | string | | — | The default branch name. | | `issues_enabled` | boolean | | — | Enable issues feature. | | `snippets_enabled` | boolean | | — | Enable snippets feature. | | `build_git_strategy` | string | | — | Git strategy for builds. | | `merge_requests_enabled` | boolean | | — | Enable merge requests feature. | | `container_registry_enabled` | boolean | | — | Enable container registry. | *** ### `Gitlab Create Project Issue` Integration name: **GITLAB\_CREATE\_PROJECT\_ISSUE** Tool to create a new issue in a GitLab project. Use when you need to report a bug, request a feature, or track a task within a specific project. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------------------------------- | ------- | :------: | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | ✅ | `"12345"` | The global ID or URL-encoded path of the project (e.g., '12345', 'my-group/my-project', or 'my-group%2Fmy-project'). | | `iid` | integer | | — | The internal ID of the project’s issue (requires administrator or project owner rights). | | `title` | string | ✅ | `"Issue with authentication"` | The title of an issue. | | `labels` | string | | `"bug,critical"` | Comma-separated label names to assign to the new issue. If a label does not already exist, this creates a new project label and assigns it to the issue. | | `weight` | integer | | `5` | The weight of the issue. Valid values are greater than or equal to 0. Premium and Ultimate only. | | `epic_id` | integer | | `42` | ID of the epic to add the issue to. Valid values are greater than or equal to 0. Premium and Ultimate only. | | `due_date` | string | | `"2016-03-11"` | The due date. Date time string in the format `YYYY-MM-DD`, for example `2016-03-11`. | | `epic_iid` | integer | | `5` | IID of the epic to add the issue to. Valid values are greater than or equal to 0. (deprecated, scheduled for removal in API version 5). Premium and Ultimate only. | | `created_at` | string | | `"2016-03-11T03:45:40Z"` | When the issue was created. Date time string, ISO 8601 formatted, for example `2016-03-11T03:45:40Z`. Requires administrator or project/group owner rights. | | `issue_type` | string | | — | The type of issue. One of `issue`, `incident`, `test_case` or `task`. Default is `issue`. | | `assignee_id` | integer | | `1` | The ID of the user to assign the issue to. Only appears on GitLab Free. | | `description` | string | | `"This is a bug report."` | The description of an issue. Limited to 1,048,576 characters. | | `assignee_ids` | array | | `[1,2]` | The IDs of the users to assign the issue to. Premium and Ultimate only. | | `confidential` | boolean | | — | Set an issue to be confidential. Default is false. | | `milestone_id` | integer | | — | The global ID of a milestone to assign issue. To find the `milestone_id` associated with a milestone, view an issue with the milestone assigned and use the API to retrieve the issue’s details. | | `discussion_to_resolve` | string | | — | The ID of a discussion to resolve. This fills out the issue with a default description and mark the discussion as resolved. Use in combination with `merge_request_to_resolve_discussions_of`. | | `merge_request_to_resolve_discussions_of` | integer | | — | The IID of a merge request in which to resolve all issues. This fills out the issue with a default description and mark all discussions as resolved. When passing a description or title, these values take precedence over the default values. | *** ### `Gitlab Create Repository Branch` Integration name: **GITLAB\_CREATE\_REPOSITORY\_BRANCH** Tool to create a new branch in a project. Use when you need to create a new branch from an existing branch or a specific commit in a GitLab project. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ---------------------- | ------------------------------------------------------------ | | `ref` | string | ✅ | `"main"` | The branch name or commit SHA to create the new branch from. | | `project_id` | — | ✅ | `"5"` | The ID or URL-encoded path of the project. | | `branch_name` | string | ✅ | `"new-feature-branch"` | The name of the new branch. | *** ### `Gitlab Delete Project` Integration name: **GITLAB\_DELETE\_PROJECT** Tool to delete a GitLab project by its ID. Use when you need to remove a project, either by marking it for later deletion or deleting it immediately. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------------- | ------- | :------: | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `id` | — | ✅ | `"123"` | The ID or URL-encoded path of the project to be deleted. | | `full_path` | string | | `"my_namespace/my_project"` | The full path of the project (e.g., namespace/project\_name). Used with `permanently_remove=true` for immediate deletion. Available in GitLab Free from 18.0 (previously Premium/Ultimate only since 15.11). | | `permanently_remove` | boolean | | `true` | If true, the project is deleted immediately. Otherwise, it is marked for deletion and removed after a retention period. Available in GitLab Free from 18.0 (previously Premium/Ultimate only since 15.11). | *** ### `Gitlab Download Project Avatar` Integration name: **GITLAB\_DOWNLOAD\_PROJECT\_AVATAR** Tool to download a project's avatar image. Use when you need the raw avatar bytes after confirming the project exists. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ------- | ------------------------------------------------------------------- | | `id` | string | ✅ | `"123"` | The ID or URL-encoded path of the project whose avatar to download. | *** ### `Gitlab Erase Job` Integration name: **GITLAB\_ERASE\_JOB** Tool to erase the content of a specified job within a project. Use when you need to remove job artifacts and logs. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------- | ------------------------------------------ | | `job_id` | integer | ✅ | `456` | The ID of the job to be erased. | | `project_id` | — | ✅ | `"123"` | The ID or URL-encoded path of the project. | *** ### `Gitlab Get Commit Refs` Integration name: **GITLAB\_GET\_COMMIT\_REFS** Tool to get all references (branches or tags) a commit is pushed to. Use when you need to find out which branches or tags a specific commit belongs to in a GitLab project. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | -------------------------------------------- | ---------------------------------------------------------------------------- | | `sha` | string | ✅ | `"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"` | The commit hash. | | `ref_type` | string | | `"branch"` | The scope of commits to list. Possible values are `branch`, `tag`, or `all`. | | `project_id` | — | ✅ | `"123"` | The ID or URL-encoded path of the project. | *** ### `Gitlab Get Commit Sequence` Integration name: **GITLAB\_GET\_COMMIT\_SEQUENCE** Tool to get the sequence number of a commit in a project by following parent links from the given commit. Use when you need to determine the order of a commit in the project's history. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | -------------------------------------------- | --------------------------------------------------------------- | | `sha` | string | ✅ | `"5937ac0a7beb003549fc5fd26fc247adbce4a52e"` | The commit hash. | | `project_id` | — | ✅ | `"5"` | The ID or URL-encoded path of the project. | | `first_parent` | boolean | | — | Follow only the first parent commit upon seeing a merge commit. | *** ### `Gitlab Get Group` Integration name: **GITLAB\_GET\_GROUP** Tool to retrieve information about a specific group by its ID. Use when you need to get details of a GitLab group. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------ | ------- | :------: | ------- | --------------------------------------------------------------------------------------------------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the group. | | `with_projects` | boolean | | — | Include details from projects that belong to the specified group (defaults to true). Deprecated, scheduled for removal in API v5. | | `with_custom_attributes` | boolean | | — | Include custom attributes in response (administrators only). | *** ### `Gitlab Get Group Member` Integration name: **GITLAB\_GET\_GROUP\_MEMBER** Tool to retrieve details for a specific group member. Use when you need to fetch membership information for a user in a group after you know both group ID and user ID. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | -------------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the group. | | `user_id` | integer | ✅ | `42` | The user ID of the group member to retrieve. | *** ### `Gitlab Get Groups` Integration name: **GITLAB\_GET\_GROUPS** Get Groups #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------ | ------- | :------: | ---------- | ------------------------------------------------------------------------------------------------- | | `page` | integer | | — | Page number for pagination. | | `sort` | string | | `"asc"` | Return groups sorted in 'asc' or 'desc' order. | | `owned` | boolean | | — | Limit to groups owned by the current user. | | `search` | string | | `"gitlab"` | Search for groups by name or path. | | `order_by` | string | | `"name"` | Return groups ordered by this field. Use 'similarity' when searching to order by relevance score. | | `per_page` | integer | | — | Number of results per page. | | `statistics` | boolean | | `true` | Include group statistics (admin only). | | `skip_groups` | array | | `[1,2,3]` | List of group IDs to exclude. | | `all_available` | boolean | | — | Include all groups the user has access to (admin only). | | `with_projects` | boolean | | — | Include project details in response (deprecated). | | `with_two_factor` | boolean | | `true` | Include groups requiring two-factor authentication. | | `min_access_level` | integer | | `10` | Limit to groups with minimum access level. | | `with_custom_attributes` | boolean | | — | Include custom attributes in response (admins only). | *** ### `Gitlab Get Job Details` Integration name: **GITLAB\_GET\_JOB\_DETAILS** Tool to retrieve details of a single job by its ID within a specified project. Use this when you need to fetch specific information about a particular CI/CD job. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------- | ------------------------------------------ | | `job_id` | integer | ✅ | `456` | The ID of the job. | | `project_id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | *** ### `Gitlab Get Merge Request Notes` Integration name: **GITLAB\_GET\_MERGE\_REQUEST\_NOTES** Tool to fetch comments on a merge request. Use when you need to retrieve all notes for a specific merge request. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ------- | ------------------------------------------ | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | | `page` | integer | | `1` | Page number to retrieve. | | `per_page` | integer | | `20` | Number of notes per page (max 100). | | `merge_request_iid` | integer | ✅ | `1` | Internal ID of the merge request. | *** ### `Gitlab Get Project` Integration name: **GITLAB\_GET\_PROJECT** Tool to get a single project by ID or URL-encoded path. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ---- | :------: | ------- | ------------------------------------------ | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | *** ### `Gitlab Get Project Languages` Integration name: **GITLAB\_GET\_PROJECT\_LANGUAGES** Tool to list programming languages used in a project with percentages. Use when you need the project language breakdown. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ---- | :------: | ------- | ------------------------------------------ | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | *** ### `Gitlab Get Project Member` Integration name: **GITLAB\_GET\_PROJECT\_MEMBER** Tool to retrieve details for a specific project member. Use after confirming project and user IDs to fetch membership information for a project member. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ---------------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | | `user_id` | integer | ✅ | `42` | The user ID of the project member to retrieve. | *** ### `Gitlab Get Project Member All` Integration name: **GITLAB\_GET\_PROJECT\_MEMBER\_ALL** Tool to retrieve details for a specific project member (including inherited and invited members). Use when you need the effective membership info (including invitations and inheritance). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------------ | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | | `user_id` | integer | ✅ | `42` | The user ID of the project member. | *** ### `Gitlab Get Project Merge Request` Integration name: **GITLAB\_GET\_PROJECT\_MERGE\_REQUEST** Tool to fetch full details for a single merge request when the MR IID is known. Use when you need to retrieve canonical metadata, description, state, branches, authors, and approval-related fields for a specific merge request. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------------------------- | ------- | :------: | ------- | --------------------------------------------------------------------- | | `id` | — | ✅ | `"123"` | The ID or URL-encoded path of the project. | | `render_html` | boolean | | `true` | If true, response includes rendered HTML for title and description. | | `merge_request_iid` | integer | ✅ | `42` | Internal ID of the merge request. | | `include_rebase_in_progress` | boolean | | `false` | If true, response includes whether a rebase operation is in progress. | | `include_diverged_commits_count` | boolean | | `false` | If true, response includes the commits behind the target branch. | *** ### `Gitlab Get Project Merge Request Commits` Integration name: **GITLAB\_GET\_PROJECT\_MERGE\_REQUEST\_COMMITS** Tool to get commits of a merge request. Use when you need to retrieve all commits associated with a specific merge request. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ------- | ------------------------------------------ | | `id` | — | ✅ | `"5"` | The ID or URL-encoded path of the project. | | `merge_request_iid` | integer | ✅ | `1` | Internal ID of the merge request. | *** ### `Gitlab Get Project Merge Requests` Integration name: **GITLAB\_GET\_PROJECT\_MERGE\_REQUESTS** Tool to retrieve a list of merge requests for a specific project. Use when you need to get all merge requests associated with a project, with options to filter by state, labels, milestones, and other attributes. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | — | ✅ | `"123"` | The ID or URL-encoded path of the project. | | `wip` | string | | `"yes"` | Filter merge requests against their wip status. | | `iids` | array | | `[42,43]` | Returns the request having the given iid. | | `page` | integer | | `1` | The page of results to return. Defaults to 1. | | `sort` | string | | `"asc"` | Returns requests sorted in the specified order. Default is desc. | | `view` | string | | `"simple"` | If simple, returns the iid, URL, title, description, and basic state of merge request. | | `scope` | string | | `"all"` | Returns merge requests for the given scope. Defaults to created\_by\_me. | | `state` | string | | `"opened"` | Returns merge requests filtered by state. | | `labels` | string | | `"bug,reproduced"` | Returns merge requests matching a comma-separated list of labels. None lists all merge requests with no labels. Any lists all merge requests with at least one label. Predefined names are case-insensitive. | | `search` | string | | `"fix login page"` | Search merge requests against their title and description. | | `approved` | string | | `"yes"` | Filters merge requests by their approved status. Requires the mr\_approved\_filter feature flag, disabled by default. | | `order_by` | string | | `"updated_at"` | Returns requests ordered by the specified field. Default is created\_at. | | `per_page` | integer | | `20` | The number of results per page. Defaults to 20. | | `author_id` | integer | | `456` | Returns merge requests created by the given user id. Mutually exclusive with author\_username. Combine with scope=all or scope=assigned\_to\_me. | | `milestone` | string | | `"release"` | Returns merge requests for a specific milestone. None returns merge requests with no milestone. Any returns merge requests that have an assigned milestone. | | `not_filter` | object | | `{"labels":"bug","milestone":"release"}` | Returns merge requests that do not match the parameters supplied. Accepts: labels, milestone, author\_id, author\_username, assignee\_id, assignee\_username, reviewer\_id, reviewer\_username, my\_reaction\_emoji. | | `assignee_id` | integer | | `123` | Returns merge requests assigned to the given user id. None returns unassigned merge requests. Any returns merge requests with an assignee. | | `environment` | string | | `"production"` | Returns merge requests deployed to the given environment. | | `reviewer_id` | integer | | `101` | Returns merge requests which have the user as a reviewer with the given user id. None returns merge requests with no reviewers. Any returns merge requests with any reviewer. Mutually exclusive with reviewer\_username. | | `approver_ids` | array | | `[4,5]` | Returns merge requests which have specified all the users with the given id as individual approvers. None returns merge requests without approvers. Any returns merge requests with an approver. Premium and Ultimate only. | | `created_after` | string | | `"2019-03-15T08:00:00Z"` | Returns merge requests created on or after the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | | `merge_user_id` | integer | | `789` | Returns the merge requests merged by the user with the given user id. Mutually exclusive with merge\_user\_username. Introduced in GitLab 17.0. | | `source_branch` | string | | `"feature-branch"` | Returns merge requests with the given source branch. | | `target_branch` | string | | `"main"` | Returns merge requests with the given target branch. | | `updated_after` | string | | `"2019-03-15T08:00:00Z"` | Returns merge requests updated on or after the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | | `created_before` | string | | `"2019-03-16T08:00:00Z"` | Returns merge requests created on or before the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | | `deployed_after` | string | | `"2019-03-15T08:00:00Z"` | Returns merge requests deployed after the given date/time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | | `updated_before` | string | | `"2019-03-16T08:00:00Z"` | Returns merge requests updated on or before the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | | `approved_by_ids` | array | | `[1,2,3]` | Returns merge requests approved by all the users with the given id, up to 5 users. None returns merge requests with no approvals. Any returns merge requests with an approval. Premium and Ultimate only. | | `author_username` | string | | `"john_doe"` | Returns merge requests created by the given username. Mutually exclusive with author\_id. | | `deployed_before` | string | | `"2019-03-16T08:00:00Z"` | Returns merge requests deployed before the given date/time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | | `my_reaction_emoji` | string | | `"star"` | Returns merge requests reacted by the authenticated user by the given emoji. None returns issues not given a reaction. Any returns issues given at least one reaction. | | `reviewer_username` | string | | `"reviewer_username"` | Returns merge requests which have the user as a reviewer with the given username. None returns merge requests with no reviewers. Any returns merge requests with any reviewer. Mutually exclusive with reviewer\_id. | | `merge_user_username` | string | | `"jane_doe"` | Returns the merge requests merged by the user with the given username. Mutually exclusive with merge\_user\_id. Introduced in GitLab 17.0. | | `with_labels_details` | boolean | | `true` | If true, response returns more details for each label in labels field: :name, :color, :description, :description\_html, :text\_color. Default is false. | | `with_merge_status_recheck` | boolean | | `true` | If true, this projection requests (but does not guarantee) an asynchronous recalculation of the merge\_status field. Enable the restrict\_merge\_status\_recheck feature flag to ignore this attribute when requested by users without at least the Developer role. | *** ### `Gitlab Get Projects` Integration name: **GITLAB\_GET\_PROJECTS** Tool to list all projects accessible to the authenticated user. Supports filtering. Private or group projects may be silently omitted if the token lacks sufficient scopes or group membership. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------------------- | ------- | :------: | ------- | ----------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | | — | Page number for pagination. Iterate incrementally until an empty result is returned to retrieve a complete project inventory. | | `sort` | string | | — | Return projects sorted in 'asc' or 'desc' order. Default is 'desc'. | | `owned` | boolean | | — | Limit by projects explicitly owned by the current user. | | `search` | string | | — | Return list of projects matching search criteria (case-insensitive substring). | | `simple` | boolean | | — | Return only limited fields for each project. | | `starred` | boolean | | — | Limit by projects starred by the current user. | | `archived` | boolean | | — | Limit by archived status. | | `id_after` | integer | | — | Limit results to projects with IDs greater than the specified ID. | | `order_by` | string | | — | Return projects ordered by this field. Default is 'created\_at'. | | `per_page` | integer | | — | Number of items per page (1-100). | | `id_before` | integer | | — | Limit results to projects with IDs less than the specified ID. | | `membership` | boolean | | — | Limit by projects that the current user is a member of. | | `statistics` | boolean | | — | Include project statistics. Available to Reporter role and above. | | `visibility` | string | | — | Limit by project visibility. | | `min_access_level` | integer | | — | Limit by current user minimal role (access\_level). | | `with_issues_enabled` | boolean | | — | Limit by enabled issues feature. | | `with_custom_attributes` | boolean | | — | Include custom attributes in response (admin only). | | `with_programming_language` | string | | — | Limit by projects which use the given programming language. | | `with_merge_requests_enabled` | boolean | | — | Limit by enabled merge requests feature. | *** ### `Gitlab Get Projects Id Merge Requests Iid Diffs` Integration name: **GITLAB\_GET\_PROJECTS\_ID\_MERGE\_REQUESTS\_IID\_DIFFS** Tool to list all diff versions of a merge request. Use when you need to inspect changes across different diff versions after creating or updating a merge request. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ------- | ------------------------------------------ | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | | `merge_request_iid` | integer | ✅ | `42` | The internal ID of the merge request. | *** ### `Gitlab Get Repository Branch` Integration name: **GITLAB\_GET\_REPOSITORY\_BRANCH** Tool to retrieve information about a specific branch in a project. Use when you need to get details for a single branch. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | -------- | ------------------------------------------ | | `project_id` | — | ✅ | `"5"` | The ID or URL-encoded path of the project. | | `branch_name` | string | ✅ | `"main"` | The URL-encoded name of the branch. | *** ### `Gitlab Get Repository Branches` Integration name: **GITLAB\_GET\_REPOSITORY\_BRANCHES** Retrieves a list of repository branches for a project. Use this when you need to get all branches or search for specific branches within a GitLab project. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `regex` | string | | `".*hotfix.*"` | Return list of branches with names matching a re2 regular expression. | | `search` | string | | `"feature"` | Return list of branches containing the search string. Use `^term` to find branches that begin with `term`, and `term$` to find branches that end with `term`. | | `project_id` | — | ✅ | `"5"` | The ID or URL-encoded path of the project. | *** ### `Gitlab Get Single Commit` Integration name: **GITLAB\_GET\_SINGLE\_COMMIT** Tool to get a specific commit identified by the commit hash or name of a branch or tag. Use this when you need to retrieve detailed information about a single commit in a GitLab project repository. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | -------- | ------------------------------------------------------ | | `id` | — | ✅ | `5` | The ID or URL-encoded path of the project. | | `sha` | string | ✅ | `"main"` | The commit hash or name of a repository branch or tag. | | `stats` | boolean | | — | Include commit stats. Default is true. | *** ### `Gitlab Get Single Pipeline` Integration name: **GITLAB\_GET\_SINGLE\_PIPELINE** Tool to retrieve details of a single pipeline by its ID within a specified project. Use when you need to get information about a specific CI/CD pipeline. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------- | ------------------------------------------ | | `project_id` | — | ✅ | `"123"` | The ID or URL-encoded path of the project. | | `pipeline_id` | integer | ✅ | `456` | The ID of the pipeline. | *** ### `Gitlab Get User` Integration name: **GITLAB\_GET\_USER** Tool to retrieve information about a specific user by their ID. Use when you need to fetch details for a single GitLab user. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------- | | `id` | integer | ✅ | `12345` | The ID of the user. | *** ### `Gitlab Get User Preferences` Integration name: **GITLAB\_GET\_USER\_PREFERENCES** Tool to get the current user's preferences. Use when you need to retrieve the user's diff display and CI identity JWT settings after authentication. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Gitlab Get Users` Integration name: **GITLAB\_GET\_USERS** Tool to retrieve a list of users from GitLab. Use this when you need to find user information, search for specific users, or filter users based on various criteria like activity status or creation date. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | | — | Page number for pagination. | | `sort` | string | | — | Return users sorted in 'asc' or 'desc' order. Default is 'desc'. (Admin only) | | `active` | boolean | | — | Filters only active users. Default is false. | | `admins` | boolean | | — | Return only administrators. Default is false. (Admin only) | | `humans` | boolean | | — | Filters only regular users that are not bot or internal users. Default is false. | | `search` | string | | `"John"` | Search for users by name, username, or public email. | | `blocked` | boolean | | — | Filters only blocked users. Default is false. | | `auditors` | boolean | | — | Return only auditor users. Default is false. If not included, it returns all users. (Admin only, Premium and Ultimate only) | | `external` | boolean | | — | Filters only external users. Default is false. | | `order_by` | string | | — | Return users ordered by 'id', 'name', 'username', 'created\_at', or 'updated\_at' fields. Default is 'id'. (Admin only) | | `per_page` | integer | | — | Number of items per page for pagination. | | `provider` | string | | `"ldapmain"` | The external provider. (Admin only) | | `username` | string | | `"john_doe"` | Get a single user with a specific username. | | `skip_ldap` | boolean | | — | Skip LDAP users. (Admin only, Premium and Ultimate only) | | `extern_uid` | string | | `"external_user_123"` | Get a single user with a specific external authentication provider UID. (Admin only) | | `two_factor` | string | | — | Filter users by Two-factor authentication. Filter values are 'enabled' or 'disabled'. (Admin only) | | `created_after` | string | | `"2023-01-01T00:00:00Z"` | Return users created after specified time (ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ). | | `created_before` | string | | `"2023-12-31T23:59:59Z"` | Return users created before specified time (ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ). | | `exclude_active` | boolean | | — | Filters only non active users. Default is false. | | `exclude_humans` | boolean | | — | Filters only bot or internal users. Default is false. | | `exclude_external` | boolean | | — | Filters only non external users. Default is false. | | `exclude_internal` | boolean | | — | Filters only non internal users. Default is false. | | `without_projects` | boolean | | — | Filter users without projects. Default is false. (Admin only) | | `without_project_bots` | boolean | | — | Filters user without project bots. Default is false. | *** ### `Gitlab Get Users Id Status` Integration name: **GITLAB\_GET\_USERS\_ID\_STATUS** Tool to get a user's status by ID. Use when you need to retrieve a GitLab user's current status message, emoji, and availability after identifying their user ID. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | -------------------------------------------------------------------- | | `user_id` | integer | ✅ | `12345` | The numeric ID of the GitLab user whose status you want to retrieve. | *** ### `Gitlab Get User Status` Integration name: **GITLAB\_GET\_USER\_STATUS** Tool to get the current user's status. Use when displaying or verifying the authenticated user's GitLab status after login. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Gitlab Get User Support Pin` Integration name: **GITLAB\_GET\_USER\_SUPPORT\_PIN** Tool to get details of the current user's Support PIN. Use when you need to retrieve the active support PIN and its expiration for the authenticated user. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Gitlab Import Project Members` Integration name: **GITLAB\_IMPORT\_PROJECT\_MEMBERS** Tool to import members from one project to another. Use when migrating members between projects. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ------- | -------------------------------------------------------------------- | | `id` | string | ✅ | `"5"` | ID or URL-encoded path of the target project to receive members. | | `project_id` | string | ✅ | `"32"` | ID or URL-encoded path of the source project to import members from. | *** ### `Gitlab List All Group Members` Integration name: **GITLAB\_LIST\_ALL\_GROUP\_MEMBERS** Tool to list all members of a group including direct, inherited, and invited members. Use when you need a comprehensive membership list beyond direct members. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------- | ---------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the group. | | `page` | integer | | — | Page number for pagination. | | `per_page` | integer | | — | Number of items per page for pagination. | *** ### `Gitlab List All Project Members` Integration name: **GITLAB\_LIST\_ALL\_PROJECT\_MEMBERS** Tool to list all members of a project (direct, inherited, invited). Use when you need the effective membership list including inherited and invited members. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------- | ------- | :------: | ---------- | -------------------------------------------------------------------------------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | | `page` | integer | | `1` | Page number for pagination. | | `query` | string | | — | Filters results based on a given name, email, or username. Use partial values to widen the scope of the query. | | `state` | string | | `"active"` | Filter results by member state, one of 'awaiting' or 'active'. Premium and Ultimate only. | | `per_page` | integer | | `20` | Number of items per page for pagination. | | `user_ids` | array | | `[1,2,3]` | Filter the results on the given user IDs. | | `show_seat_info` | boolean | | — | Show seat information for users. | *** ### `Gitlab List Billable Group Members` Integration name: **GITLAB\_LIST\_BILLABLE\_GROUP\_MEMBERS** Tool to list billable members of a top-level group (including its subgroups and projects). Use when generating billing reports; requires Owner role on the group. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the top-level group. Only top-level groups are supported. | | `page` | integer | | `1` | Page number for pagination (must be ≥ 1). | | `sort` | string | | `"access_level_desc"` | Sort order for results. Supported values: access\_level\_asc\|access\_level\_desc\|last\_joined\|name\_asc\|name\_desc\|oldest\_joined\|oldest\_sign\_in\|recent\_sign\_in\|last\_activity\_on\_asc\|last\_activity\_on\_desc. | | `search` | string | | `"john"` | Search string to filter members by name, username, or public email. | | `per_page` | integer | | `20` | Number of items per page for pagination (must be ≥ 1). | *** ### `Gitlab List Group Members` Integration name: **GITLAB\_LIST\_GROUP\_MEMBERS** Tool to list direct members of a group. Use when you need to retrieve or filter a group's direct membership. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ------------------------ | -------------------------------------------------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the group. | | `page` | integer | | `1` | Page number for pagination. | | `sort` | string | | `"access_level_desc"` | Order results by access level, ascending or descending. | | `query` | string | | `"alice"` | Filter members by name, username, or email substring. | | `active` | boolean | | `true` | When true, return only active users. | | `per_page` | integer | | `20` | Number of results per page (1–100). | | `relations` | array | | `["direct","inherited"]` | Membership relation types to include: direct, descendants, inherited, or shared. | | `skip_users` | array | | `[42,84]` | List of user IDs to exclude from the results. | | `two_factor` | string | | `"enabled"` | Filter users by two-factor authentication status. | | `include_inherited` | boolean | | — | Include members inherited from ancestor groups when true. | *** ### `Gitlab List Group Projects` Integration name: **GITLAB\_LIST\_GROUP\_PROJECTS** Tool to list projects within a GitLab group by group ID or full path. Use when discovering projects under a namespace or subgroup. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------------------- | ------- | :------: | ------- | --------------------------------------------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the group. | | `page` | integer | | — | Page number for pagination. | | `sort` | string | | — | Return projects sorted in ascending or descending order. Default is 'desc'. | | `owned` | boolean | | — | Limit by projects owned by the current user. | | `search` | string | | — | Return list of projects matching the search criteria. | | `simple` | boolean | | — | Return only limited fields for each project. | | `starred` | boolean | | — | Limit by projects starred by the current user. | | `archived` | boolean | | — | Limit by archived status. | | `order_by` | string | | — | Return projects ordered by this field. Default is 'created\_at'. | | `per_page` | integer | | — | Number of items per page (1-100). | | `visibility` | string | | — | Limit by visibility level. | | `with_shared` | boolean | | — | Include projects shared to this group. Default is true. | | `min_access_level` | integer | | — | Limit to projects where current user has at least this access level. | | `include_subgroups` | boolean | | — | Include projects in subgroups of this group. Default is false. | | `with_issues_enabled` | boolean | | — | Limit by projects with issues feature enabled. Default is false. | | `with_security_reports` | boolean | | — | Return only projects with security reports artifacts. Default is false. | | `with_custom_attributes` | boolean | | — | Include custom attributes in response (administrators only). | | `with_merge_requests_enabled` | boolean | | — | Limit by projects with merge requests feature enabled. Default is false. | *** ### `Gitlab List Pending Group Members` Integration name: **GITLAB\_LIST\_PENDING\_GROUP\_MEMBERS** Tool to list pending members of a group and its subgroups and projects. Use when you need to review users awaiting approval or invited without an account. Call after confirming the top-level group ID. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------- | -------------------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the top-level group. | | `page` | integer | | `1` | Page number for pagination (1-based index). | | `per_page` | integer | | `20` | Number of items per page for pagination (max 100). | *** ### `Gitlab List Pipeline Jobs` Integration name: **GITLAB\_LIST\_PIPELINE\_JOBS** Tool to retrieve a list of jobs for a specified pipeline within a project. Use this when you need to inspect the status or details of jobs associated with a particular CI/CD pipeline. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ----------- | ---------------------------------------------------------------------------------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | | `page` | integer | | `1` | Page number for pagination (1-based). | | `scope` | — | | `"running"` | The scope of jobs to show. Can be a single status or a list of statuses. If not provided, all jobs are returned. | | `per_page` | integer | | `20` | Number of items per page for pagination (max 100). | | `pipeline_id` | integer | ✅ | `456` | The ID of the pipeline. | | `include_retried` | boolean | | — | Include retried jobs in the response. Defaults to false. | *** ### `Gitlab List Project Groups` Integration name: **GITLAB\_LIST\_PROJECT\_GROUPS** Tool to list ancestor groups of a project. Use when you need to retrieve all groups a project belongs to or is shared with. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------- | ------- | :------: | --------- | ---------------------------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | | `page` | integer | | `1` | Page number of the results to retrieve. | | `search` | string | | `"foo"` | Search for specific groups by name. | | `per_page` | integer | | `20` | Number of items to return per page. | | `skip_groups` | array | | `[1,2,3]` | Skip the group IDs passed. | | `with_shared` | boolean | | `true` | Include projects shared with this group. Default is false. | | `shared_visible_only` | boolean | | `true` | Limit to shared groups user has access to. | | `shared_min_access_level` | integer | | `10` | Limit to shared groups with at least this access level. | *** ### `Gitlab List Project Invited Groups` Integration name: **GITLAB\_LIST\_PROJECT\_INVITED\_GROUPS** Tool to list groups invited to a project. Use when auditing which groups have access to a project. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------- | ------------------------------------------ | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | | `page` | integer | | `1` | Page number for pagination. | | `per_page` | integer | | `20` | Number of items to return per page. | *** ### `Gitlab List Project Issues` Integration name: **GITLAB\_LIST\_PROJECT\_ISSUES** Tool to list issues for a project with filtering options (state, labels, search, assignee, author, etc.). Use when you need to browse, filter, or triage project issues to confirm IIDs or decide what to update/close. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | — | ✅ | `"123"` | Project identifier: numeric ID (e.g., 123) or namespace path in format 'namespace/project-name' (e.g., 'my-group/my-project'). Path must use forward slash / as separator. URL-encoding is handled automatically. | | `iids` | array | | `[1,2,3]` | Return specific issues by their internal IDs. | | `page` | integer | | `1` | The page of results to return. Defaults to 1. | | `sort` | string | | `"asc"` | Order direction. Default: desc. | | `scope` | string | | `"all"` | Filter scope. Default: all. | | `state` | string | | `"opened"` | Filter by issue state. | | `labels` | string | | `"bug,critical"` | Comma-separated label names; issues must have all specified labels. | | `search` | string | | `"authentication bug"` | Search in title and description. | | `weight` | integer | | `3` | Filter by weight value. Premium/Ultimate only. | | `epic_id` | integer | | `42` | Issues associated with a specific epic ID. Premium/Ultimate only. | | `due_date` | string | | `"overdue"` | Filter by due date status. | | `order_by` | string | | `"updated_at"` | Sort by the specified field. Default: created\_at. | | `per_page` | integer | | `20` | The number of results per page. Defaults to 20. | | `author_id` | integer | | `10` | Return issues created by a specific user ID. | | `milestone` | string | | `"v1.0"` | Filter by milestone title. | | `issue_type` | string | | `"issue"` | Filter by issue type. | | `assignee_id` | — | | `5` | Return issues assigned to a specific user ID. Use the string 'None' for unassigned issues or 'Any' for issues assigned to someone. | | `confidential` | boolean | | `false` | Filter confidential or public issues. | | `iteration_id` | integer | | `7` | Issues assigned to a specific iteration. Premium/Ultimate only. | | `created_after` | string | | `"2019-03-15T08:00:00Z"` | Issues created on or after this time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | | `updated_after` | string | | `"2019-03-15T08:00:00Z"` | Issues updated on or after this time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | | `created_before` | string | | `"2019-03-16T08:00:00Z"` | Issues created on or before this time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | | `updated_before` | string | | `"2019-03-16T08:00:00Z"` | Issues updated on or before this time. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | | `author_username` | string | | `"jane_doe"` | Return issues created by a specific username. | | `iteration_title` | string | | `"Sprint 1"` | Issues assigned to iteration with given title. Premium/Ultimate only. | | `assignee_username` | array | | `["john_doe"]` | Return issues assigned to given username(s). | | `my_reaction_emoji` | string | | `"thumbsup"` | Issues reacted to by authenticated user with specified emoji. | | `with_labels_details` | boolean | | `true` | Return detailed label information (name, color, description, HTML description, text color). Default: false. | *** ### `Gitlab List Project Pipelines` Integration name: **GITLAB\_LIST\_PROJECT\_PIPELINES** Tool to retrieve a list of pipelines for a specified project. Use when you need to get information about CI/CD pipelines, such as their status, source, or creation/update times. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------- | | `id` | — | ✅ | — | The ID or URL-encoded path of the project. | | `ref` | string | | — | The ref of pipelines. | | `sha` | string | | — | The SHA of pipelines. | | `name` | string | | — | Return pipelines with the specified name. | | `page` | integer | | — | Page number for pagination. | | `sort` | string | | — | Sort pipelines in 'asc' or 'desc' order. | | `scope` | string | | — | The scope of pipelines, one of: 'running', 'pending', 'finished', 'branches', 'tags'. | | `source` | string | | — | The pipeline source. To return child pipelines, set to 'parent\_pipeline'. | | `status` | string | | — | The status of pipelines. | | `order_by` | string | | — | Order pipelines by 'id', 'status', 'ref', 'updated\_at' or 'user\_id'. | | `per_page` | integer | | — | Number of items per page for pagination. | | `username` | string | | — | The username of the user who triggered pipelines. | | `yaml_errors` | boolean | | — | Returns pipelines with invalid configurations. | | `created_after` | string | | — | Return pipelines created after the specified date (ISO 8601 format). | | `updated_after` | string | | — | Return pipelines updated after the specified date (ISO 8601 format). | | `created_before` | string | | — | Return pipelines created before the specified date (ISO 8601 format). | | `updated_before` | string | | — | Return pipelines updated before the specified date (ISO 8601 format). | *** ### `Gitlab List Project Shareable Groups` Integration name: **GITLAB\_LIST\_PROJECT\_SHAREABLE\_GROUPS** Tool to list groups that can be shared with a project. Use before sharing a project to fetch eligible groups. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------------ | ---------------------------------------------- | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | | `page` | integer | | `1` | Page number for pagination. | | `search` | string | | `"dev-team"` | Search term to filter groups by name or path. | | `per_page` | integer | | `20` | Number of items per page for pagination. | | `skip_groups` | array | | `[10,20]` | List of group IDs to exclude from the results. | *** ### `Gitlab List Project Tags` Integration name: **GITLAB\_LIST\_PROJECT\_TAGS** Tool to retrieve a list of repository tags for a specified project. Use when you need to get all tags associated with a project in GitLab. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | -------- | -------------------------------------------------------------------------------------------------------------------------------- | | `id` | — | ✅ | `"5"` | The ID or URL-encoded path of the project. | | `page` | integer | | `1` | Page number of the results to retrieve. | | `sort` | string | | `"asc"` | Return tags sorted in the specified order. Default is `desc`. | | `search` | string | | `"^v1"` | Return a list of tags matching the search criteria. You can use `^term` and `term$` to find tags that begin and end with `term`. | | `order_by` | string | | `"name"` | Return tags ordered by the specified field. Default is `updated`. | | `per_page` | integer | | `20` | Number of items to return per page. | *** ### `Gitlab List Project Transfer Locations` Integration name: **GITLAB\_LIST\_PROJECT\_TRANSFER\_LOCATIONS** Tool to list namespaces available for project transfer. Use when you need to determine which groups a project can be transferred into. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------------ | ------------------------------------------ | | `id` | — | ✅ | `123` | The ID or URL-encoded path of the project. | | `page` | integer | | `1` | Page number for pagination (1-based). | | `search` | string | | `"dev-team"` | The group names to search for. | | `per_page` | integer | | `20` | Number of items per page for pagination. | *** ### `Gitlab List Project Users` Integration name: **GITLAB\_LIST\_PROJECT\_USERS** Tool to list users of a project. Use after you have a project ID and want to retrieve its users. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | -------- | -------------------------------------------------- | | `id` | string | ✅ | `"5"` | The ID or URL-encoded path of the project. | | `page` | integer | | `1` | Page number for pagination (1-based). | | `search` | string | | `"john"` | Filter users by name or username. | | `per_page` | integer | | `20` | Number of items per page for pagination (max 100). | | `skip_users` | array | | `[1,2]` | List of user IDs to exclude from the result. | *** ### `Gitlab List Repository Commits` Integration name: **GITLAB\_LIST\_REPOSITORY\_COMMITS** Tool to get a list of repository commits in a project. Use when you need to retrieve commit history for a specific project, branch, or time range. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------- | | `all` | boolean | | — | Retrieve every commit from the repository. When set to true, the ref\_name parameter is ignored. | | `page` | integer | | `1` | Page number for pagination (1-based). | | `path` | string | | `"README.md"` | The file path to filter commits by. | | `order` | string | | — | List commits in order. Possible values: default, topo. Defaults to default, the commits are shown in reverse chronological order. | | `since` | string | | `"2023-01-01T00:00:00Z"` | Only commits after or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ. | | `until` | string | | `"2023-12-31T23:59:59Z"` | Only commits before or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ. | | `author` | string | | `"john.doe@example.com"` | Search commits by commit author. | | `per_page` | integer | | `20` | Number of items per page for pagination (max 100). | | `ref_name` | string | | `"main"` | The name of a repository branch, tag or revision range, or if not given the default branch. | | `trailers` | boolean | | — | Parse and include Git trailers for every commit. | | `project_id` | — | ✅ | `"5"` | The ID or URL-encoded path of the project. | | `with_stats` | boolean | | — | Stats about each commit are added to the response. | | `first_parent` | boolean | | — | Follow only the first parent commit upon seeing a merge commit. | *** ### `Gitlab List User Projects` Integration name: **GITLAB\_LIST\_USER\_PROJECTS** Tool to list projects owned by a specific user. Use after obtaining target user identity to fetch owned projects. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------ | | `id` | — | ✅ | `123` | The ID or username of the user whose projects to list. | | `page` | integer | | — | Page number for pagination. | | `sort` | string | | — | Return projects sorted in asc or desc order. Default is 'desc'. | | `owned` | boolean | | — | Limit by projects explicitly owned by the specified user. | | `search` | string | | — | Return list of projects matching search criteria (case-insensitive substring). | | `simple` | boolean | | — | Return only limited fields for each project. | | `starred` | boolean | | — | Limit by projects starred by the specified user. | | `archived` | boolean | | — | Limit by archived status. | | `id_after` | integer | | — | Limit results to projects with IDs greater than the specified ID. | | `order_by` | string | | — | Return projects ordered by this field. Default is 'created\_at'. | | `per_page` | integer | | — | Number of items per page (1-100). | | `id_before` | integer | | — | Limit results to projects with IDs less than the specified ID. | | `membership` | boolean | | — | Limit by projects that the current user is a member of. | | `statistics` | boolean | | — | Include project statistics. Available to Reporter role and above. | | `visibility` | string | | — | Limit by project visibility. | | `updated_after` | string | | — | Limit projects updated after given time (ISO 8601). | | `updated_before` | string | | — | Limit projects updated before given time (ISO 8601). | | `min_access_level` | integer | | — | Limit by current user minimal role (access\_level). | | `with_issues_enabled` | boolean | | — | Limit by enabled issues feature. | | `with_custom_attributes` | boolean | | — | Include custom attributes in response (admin only). | | `with_programming_language` | string | | — | Limit by projects which use the given programming language. | | `with_merge_requests_enabled` | boolean | | — | Limit by enabled merge requests feature. | *** ### `Gitlab Post User Support Pin` Integration name: **GITLAB\_POST\_USER\_SUPPORT\_PIN** Tool to create a support PIN for your authenticated user. Use when GitLab Support requests a PIN to verify your identity. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Gitlab Put User Preferences` Integration name: **GITLAB\_PUT\_USER\_PREFERENCES** Tool to update the current user's preferences. Use when adjusting default diff viewing and CI identity settings. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------------------------- | ------- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `view_diffs_file_by_file` | boolean | ✅ | `true` | Flag indicating the user sees only one file diff per page. | | `show_whitespace_in_diffs` | boolean | ✅ | `false` | Flag indicating the user sees whitespace changes in diffs. | | `pass_user_identities_to_ci_jwt` | boolean | ✅ | `false` | Flag indicating the user passes their external identities as CI information. Internal use only; do not expose to third-party services. | *** ### `Gitlab Set User Status` Integration name: **GITLAB\_SET\_USER\_STATUS** Tool to set the current user's status. Use when you need to update availability or convey current mood on GitLab. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------------- | ------ | :------: | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `emoji` | string | | `"speech_balloon"` | Name of the emoji to use as status. Defaults to 'speech\_balloon' if omitted. | | `message` | string | | `"In a meeting"` | Status message to display. Max 100 characters; can contain emoji codes. | | `clear_status_after` | string | | `"3_hours"` | Automatically clear status after the specified time interval. Allowed values: 30\_minutes, 3\_hours, 8\_hours, 1\_day, 3\_days, 7\_days, 30\_days. | *** ### `Gitlab Share Project With Group` Integration name: **GITLAB\_SHARE\_PROJECT\_WITH\_GROUP** Tool to share a project with a group. Use when you need to grant a group specific access level to a project. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | -------------- | -------------------------------------------------------------------------------------------------------------- | | `id` | — | ✅ | `1` | The ID or URL-encoded path of the project. | | `group_id` | integer | ✅ | `42` | The ID of the group to share with. | | `expires_at` | string | | `"2022-12-31"` | Expiration date for the group share in YYYY-MM-DD format (ISO 8601). | | `group_access` | integer | ✅ | `30` | The access level to grant the group. One of GitLab's access levels, e.g., 30 for Developer, 40 for Maintainer. | *** ### `Gitlab Start Project Housekeeping` Integration name: **GITLAB\_START\_PROJECT\_HOUSEKEEPING** Tool to start the housekeeping task for a project. Use when you need to trigger manual maintenance or pruning on a repository. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | --------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `id` | — | ✅ | `"5"` | The ID or URL-encoded path of the project. | | `task` | string | | `"prune"` | Type of housekeeping task to perform. `prune` triggers a manual prune of unreachable objects; `eager` triggers eager housekeeping. | *** ### `Gitlab Update Project Issue` Integration name: **GITLAB\_UPDATE\_PROJECT\_ISSUE** Tool to update an existing issue in a GitLab project (title, description, labels, assignees, state, etc.). Use when you need to modify issue details, close/reopen issues, or manage labels and assignments. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `id` | — | ✅ | `"my-group/my-project"` | The global ID or URL-encoded path of the project. | | `title` | string | | `"Updated issue title"` | The title of the issue. | | `labels` | string | | `"bug,critical"` | Comma-separated label names to replace the entire label set. Set to empty string to remove all labels. | | `weight` | integer | | `3` | The weight of the issue. Valid values are greater than or equal to 0. Premium and Ultimate only. | | `epic_id` | integer | | `10` | ID of the epic to add the issue to. Valid values are greater than or equal to 0. Premium and Ultimate only. | | `due_date` | string | | `"2024-12-31"` | The due date. Date time string in the format YYYY-MM-DD. | | `issue_iid` | integer | ✅ | `42` | The internal ID of the project's issue. | | `add_labels` | string | | `"documentation"` | Comma-separated label names to add to the issue without affecting existing labels. | | `issue_type` | string | | — | The type of issue. One of 'issue', 'incident', 'test\_case', or 'task'. | | `updated_at` | string | | `"2024-01-15T10:30:00Z"` | When the issue was updated. Date time string, ISO 8601 formatted. Requires administrator or project/group owner rights. | | `description` | string | | `"This is an updated description."` | The description of the issue. Limited to 1,048,576 characters. | | `state_event` | string | | — | State event to perform on the issue. Use 'close' to close the issue or 'reopen' to reopen it. | | `assignee_ids` | array | | `[1,2]` | The IDs of the users to assign the issue to. Set to \[0] or provide empty array to unassign all. | | `confidential` | boolean | | — | Set an issue to be confidential. | | `milestone_id` | integer | | `5` | The global ID of a milestone to assign to the issue. Set to 0 to unassign milestone. | | `remove_labels` | string | | `"wontfix"` | Comma-separated label names to remove from the issue. | | `discussion_locked` | boolean | | — | Flag indicating if the issue's discussion is locked. If the discussion is locked, only project members can add or edit comments. | *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/gitlab.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.