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.
Tools (58)
Gitlab Archive Project
Gitlab Archive ProjectIntegration 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.
id
—
✅
"5"
The ID or URL-encoded path of the project to archive.
Gitlab Create Group
Gitlab Create GroupIntegration 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.
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
Gitlab Create ProjectIntegration 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.
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
Gitlab Create Project IssueIntegration 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.
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
Gitlab Create Repository BranchIntegration 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.
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
Gitlab Delete ProjectIntegration 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.
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
Gitlab Download Project AvatarIntegration 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.
id
string
✅
"123"
The ID or URL-encoded path of the project whose avatar to download.
Gitlab Erase Job
Gitlab Erase JobIntegration 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.
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
Gitlab Get Commit RefsIntegration 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.
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
Gitlab Get Commit SequenceIntegration 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.
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
Gitlab Get GroupIntegration 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.
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
Gitlab Get Group MemberIntegration 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.
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
Gitlab Get GroupsIntegration name: GITLAB_GET_GROUPS
Get Groups
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
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
Gitlab Get Job DetailsIntegration 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.
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
Gitlab Get Merge Request NotesIntegration 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.
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
Gitlab Get ProjectIntegration 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.
id
—
✅
123
The ID or URL-encoded path of the project.
Gitlab Get Project Languages
Gitlab Get Project LanguagesIntegration 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.
id
—
✅
123
The ID or URL-encoded path of the project.
Gitlab Get Project Member
Gitlab Get Project MemberIntegration 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.
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
Gitlab Get Project Member AllIntegration 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.
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
Gitlab Get Project Merge RequestIntegration 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.
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
Gitlab Get Project Merge Request CommitsIntegration 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.
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
Gitlab Get Project Merge RequestsIntegration 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.
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
Gitlab Get ProjectsIntegration 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.
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
Gitlab Get Projects Id Merge Requests Iid DiffsIntegration 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.
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
Gitlab Get Repository BranchIntegration 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.
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
Gitlab Get Repository BranchesIntegration 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.
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
Gitlab Get Single CommitIntegration 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.
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
Gitlab Get Single PipelineIntegration 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.
project_id
—
✅
"123"
The ID or URL-encoded path of the project.
pipeline_id
integer
✅
456
The ID of the pipeline.
Gitlab Get User
Gitlab Get UserIntegration 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.
id
integer
✅
12345
The ID of the user.
Gitlab Get User Preferences
Gitlab Get User PreferencesIntegration 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
Gitlab Get UsersIntegration 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.
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
Gitlab Get Users Id StatusIntegration 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.
user_id
integer
✅
12345
The numeric ID of the GitLab user whose status you want to retrieve.
Gitlab Get User Status
Gitlab Get User StatusIntegration 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
Gitlab Get User Support PinIntegration 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
Gitlab Import Project MembersIntegration 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.
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
Gitlab List All Group MembersIntegration 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.
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
Gitlab List All Project MembersIntegration 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.
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
Gitlab List Billable Group MembersIntegration 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.
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
Gitlab List Group MembersIntegration 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.
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
Gitlab List Group ProjectsIntegration 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.
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
Gitlab List Pending Group MembersIntegration 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.
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
Gitlab List Pipeline JobsIntegration 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.
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
Gitlab List Project GroupsIntegration 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.
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
Gitlab List Project Invited GroupsIntegration 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.
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
Gitlab List Project IssuesIntegration 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.
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
Gitlab List Project PipelinesIntegration 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.
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
Gitlab List Project Shareable GroupsIntegration 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.
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
Gitlab List Project TagsIntegration 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.
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
Gitlab List Project Transfer LocationsIntegration 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.
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
Gitlab List Project UsersIntegration 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.
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
Gitlab List Repository CommitsIntegration 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.
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
Gitlab List User ProjectsIntegration 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.
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
Gitlab Post User Support PinIntegration 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
Gitlab Put User PreferencesIntegration 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.
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
Gitlab Set User StatusIntegration 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.
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
Gitlab Share Project With GroupIntegration 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.
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
Gitlab Start Project HousekeepingIntegration 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.
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
Gitlab Update Project IssueIntegration 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.
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.