Skip to main content
Server path: /gitlab-issues | Type: Application | PCID required: Yes

Tools

ToolDescription
gitlab_issues_create_issueCreate a new project issue
gitlab_issues_create_merge_requestCreate merge request
gitlab_issues_get_groupGet a single group, with containing projects.
gitlab_issues_get_issueGet a single project issue
gitlab_issues_get_merge_requestGet single merge request
gitlab_issues_get_merge_request_changesGet single merge request changes
gitlab_issues_get_merge_request_commitsGet single merge request commits
gitlab_issues_get_merge_request_diffsGet the merge request diffs
gitlab_issues_get_merge_request_pipelinesGet single merge request pipelines
gitlab_issues_list_groupsList all groups
gitlab_issues_list_issuesGet currently authenticated user’s issues
gitlab_issues_list_merge_requestsList merge requests
gitlab_issues_list_project_issuesGet a list of project issues
gitlab_issues_list_project_merge_requestsList project merge requests
gitlab_issues_merge_merge_requestMerge a merge request
gitlab_issues_searchSearch an instance
gitlab_issues_update_issueUpdate an existing issue
gitlab_issues_update_merge_requestUpdate merge request

gitlab_issues_create_issue

Create a new project issue Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project
add_labelsstring[]NoComma-separated list of label names
assignee_idintegerNo[Deprecated] The ID of a user to assign issue
assignee_idsinteger[]NoThe array of user IDs to assign issue
confidentialbooleanNoBoolean parameter if the issue should be confidential
created_atstringNoDate time when the issue was created. Available only for admins and project owners.
descriptionstringNoThe description of an issue
discussion_lockedbooleanNoBoolean parameter indicating if the issue’s discussion is locked
discussion_to_resolvestringNoThe ID of a discussion to resolve, also pass merge_request_to_resolve_discussions_of
due_datestringNoDate string in the format YEAR-MONTH-DAY
epic_idintegerNoThe ID of an epic to associate the issue with
epic_iidintegerNoThe IID of an epic to associate the issue with (deprecated)
iidintegerNoThe internal ID of a project issue. Available only for admins and project owners.
issue_typestringNoThe type of the issue. Accepts: issue, incident, test_case, requirement, task, ticket
labelsstring[]NoComma-separated list of label names
merge_request_to_resolve_discussions_ofintegerNoThe IID of a merge request for which to resolve discussions
milestonestringNoThe title of a project or ancestor-group milestone to assign the issue to. Mutually exclusive with milestone_id.
milestone_idintegerNoThe ID of a milestone to assign issue
remove_labelsstring[]NoComma-separated list of label names
titlestringYesThe title of an issue
weightintegerNoThe weight of the issue

gitlab_issues_create_merge_request

Create merge request Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project.
add_labelsstring[]NoComma-separated label names to add to a merge request.
allow_collaborationbooleanNoAllow commits from members who can merge to the target branch.
allow_maintainer_to_pushbooleanNo[deprecated] See allow_collaboration
approvals_before_mergeintegerNoNumber of approvals required before this can be merged
assignee_idintegerNoAssignee user ID.
assignee_idsinteger[]NoThe IDs of the users to assign the merge request to, as a comma-separated list. Set to 0 or provide an empty value to unassign all assignees.
descriptionstringNoDescription of the merge request. Limited to 1,048,576 characters.
labelsstring[]NoComma-separated label names for a merge request. Set to an empty string to unassign all labels.
merge_afterstringNoDate after which the merge request can be merged.
milestonestringNoThe title of a project or ancestor-group milestone to assign the merge request to. Mutually exclusive with milestone_id.
milestone_idintegerNoThe global ID of a milestone to assign the merge request to.
remove_labelsstring[]NoComma-separated label names to remove from a merge request.
remove_source_branchbooleanNoFlag indicating if a merge request should remove the source branch when merging.
reviewer_idsinteger[]NoThe IDs of the users to review the merge request, as a comma-separated list. Set to 0 or provide an empty value to unassign all reviewers.
source_branchstringYesThe source branch.
squashbooleanNoSquash commits into a single commit when merging.
target_branchstringYesThe target branch.
target_project_idintegerNoThe target project of the merge request defaults to the :id of the project.
titlestringYesThe title of the merge request.

gitlab_issues_get_group

Get a single group, with containing projects. Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID of a group
with_custom_attributesbooleanNoInclude custom attributes in the response
with_projectsbooleanNoOmit project details

gitlab_issues_get_issue

Get a single project issue Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project
issue_iidintegerYesThe internal ID of a project issue

gitlab_issues_get_merge_request

Get single merge request Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project.
merge_request_iidintegerYesThe internal ID of the merge request.
render_htmlbooleanNoIf true, response includes rendered HTML for title and description.
include_diverged_commits_countbooleanNoIf true, response includes the commits behind the target branch.
include_rebase_in_progressbooleanNoIf true, response includes whether a rebase operation is in progress.

gitlab_issues_get_merge_request_changes

Get single merge request changes Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project.
unidiffbooleanNoA diff in a Unified diff format
merge_request_iidintegerYesMerge Request Iid

gitlab_issues_get_merge_request_commits

Get single merge request commits Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project.
merge_request_iidintegerYesThe internal ID of the merge request.
pageintegerNoCurrent page number
per_pageintegerNoNumber of items per page

gitlab_issues_get_merge_request_diffs

Get the merge request diffs Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project.
merge_request_iidintegerYesThe internal ID of the merge request.
pageintegerNoCurrent page number
per_pageintegerNoNumber of items per page
unidiffbooleanNoA diff in a Unified diff format

gitlab_issues_get_merge_request_pipelines

Get single merge request pipelines Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project.
merge_request_iidintegerYesThe internal ID of the merge request.

gitlab_issues_list_groups

List all groups Parameters:
ParameterTypeRequiredDefaultDescription
statisticsbooleanNoInclude project statistics
archivedbooleanNoLimit by archived status
skip_groupsinteger[]NoArray of group ids to exclude from list
all_availablebooleanNoWhen true, returns all accessible groups. When false, returns only groups where the user is a member.
visibilitystringNoLimit by visibility
searchstringNoSearch for a specific group
ownedbooleanNoLimit by owned by authenticated user
order_bystringNoOrder by name, path, id or similarity if searching
sortstringNoSort by asc (ascending) or desc (descending)
min_access_levelintegerNoMinimum access level of authenticated user
top_level_onlybooleanNoOnly include top-level groups
marked_for_deletion_onstringNoReturn groups that are marked for deletion on this date
activebooleanNoLimit by groups that are not archived and not marked for deletion
repository_storagestringNoFilter by repository storage used by the group
pageintegerNoCurrent page number
per_pageintegerNoNumber of items per page
with_custom_attributesbooleanNoInclude custom attributes in the response

gitlab_issues_list_issues

Get currently authenticated user’s issues Parameters:
ParameterTypeRequiredDefaultDescription
with_labels_detailsbooleanNoReturn titles of labels and other details
statestringNoReturn opened, closed, or all issues
closed_by_idintegerNoReturn issues which were closed by the user with the given ID.
order_bystringNoReturn issues ordered by created_at, due_date, label_priority, milestone_due, popularity, priority, relative_position, title, or updated_at fields.
sortstringNoReturn issues sorted in asc or desc order.
due_datestringNoReturn issues that have no due date (0), or whose due date is this week, this month, between two weeks ago and next month, or which are overdue. Accepts: overdue, week, month, next_month_and_previous_two_weeks, 0
issue_typestringNoThe type of the issue. Accepts: issue, incident, test_case, requirement, task, ticket
labelsstring[]NoComma-separated list of label names
milestonestringNoMilestone title
milestone_idstringNoReturn issues assigned to milestones with the specified timebox value (“Any”, “None”, “Upcoming” or “Started”)
iidsinteger[]NoThe IID array of issues
searchstringNoSearch issues for text present in the title, description, or any combination of these
instringNotitle, description, or a string joining them with comma
author_idintegerNoReturn issues which are authored by the user with the given ID
author_usernamestringNoReturn issues which are authored by the user with the given username
assignee_idintegerNoReturn issues which are assigned to the user with the given ID
assignee_usernamestring[]NoReturn issues which are assigned to the user with the given username
created_afterstringNoReturn issues created after the specified time
created_beforestringNoReturn issues created before the specified time
updated_afterstringNoReturn issues updated after the specified time
updated_beforestringNoReturn issues updated before the specified time
not[labels]string[]NoComma-separated list of label names
not[milestone]stringNoMilestone title
not[milestone_id]stringNoReturn issues assigned to milestones without the specified timebox value (“Any”, “None”, “Upcoming” or “Started”)
not[iids]integer[]NoThe IID array of issues
not[author_id]integerNoReturn issues which are not authored by the user with the given ID
not[author_username]stringNoReturn issues which are not authored by the user with the given username
not[assignee_id]integerNoReturn issues which are not assigned to the user with the given ID
not[assignee_username]string[]NoReturn issues which are not assigned to the user with the given username
not[weight]integerNoReturn issues without the specified weight
not[iteration_id]integerNoReturn issues which are not assigned to the iteration with the given ID
not[iteration_title]stringNoReturn issues which are not assigned to the iteration with the given title
scopestringNoReturn issues for the given scope: created_by_me, assigned_to_me or all
my_reaction_emojistringNoReturn issues reacted by the authenticated user by the given emoji
confidentialbooleanNoFilter confidential or public issues
weightintegerNoThe weight of the issue
epic_idintegerNoThe ID of an epic associated with the issues
health_statusstringNoThe health status of the issue. Must be one of: on_track, needs_attention, at_risk, none, any
iteration_idintegerNoReturn issues which are assigned to the iteration with the given ID
iteration_titlestringNoReturn issues which are assigned to the iteration with the given title
pageintegerNoCurrent page number
per_pageintegerNoNumber of items per page
non_archivedbooleanNoReturn issues from non archived projects

gitlab_issues_list_merge_requests

List merge requests Parameters:
ParameterTypeRequiredDefaultDescription
author_idintegerNoReturns merge requests created by the given user id. Mutually exclusive with author_username. Combine with scope=all or scope=assigned_to_me.
author_usernamestringNoReturns merge requests created by the given username. Mutually exclusive with author_id.
assignee_idintegerNoReturns merge requests assigned to the given user id. None returns unassigned merge requests. Any returns merge requests with an assignee.
assignee_usernamestring[]NoReturns merge requests created by the given username. Mutually exclusive with author_id.
reviewer_usernamestringNoReturns 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. Introduced in GitLab 13.8.
labelsstring[]NoReturns 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.
milestonestringNoReturns merge requests for a specific milestone. None returns merge requests with no milestone. Any returns merge requests that have an assigned milestone.
my_reaction_emojistringNoReturns 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_idintegerNoReturns 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.
statestringNoReturns all merge requests or just those that are opened, closed, locked, or merged.
order_bystringNoReturns merge requests ordered by created_at, label_priority, milestone_due, popularity, priority, title, updated_at or merged_at fields. Introduced in GitLab 14.8.
sortstringNoReturns merge requests sorted in asc or desc order.
with_labels_detailsbooleanNoIf true, response returns more details for each label in labels field: :name,:color, :description, :description_html, :text_color
with_merge_status_recheckbooleanNoIf true, this projection requests (but does not guarantee) that the merge_status field be recalculated asynchronously. Introduced in GitLab 13.0.
created_afterstringNoReturns merge requests created on or after the given time. Expected in ISO 8601 format.
created_beforestringNoReturns merge requests created on or before the given time. Expected in ISO 8601 format.
updated_afterstringNoReturns merge requests updated on or after the given time. Expected in ISO 8601 format.
updated_beforestringNoReturns merge requests updated on or before the given time. Expected in ISO 8601 format.
viewstringNoIf simple, returns the iid, URL, title, description, and basic state of merge request
scopestringNoReturns merge requests for the given scope: created_by_me, assigned_to_me, reviews_for_me or all
source_branchstringNoReturns merge requests with the given source branch
source_project_idintegerNoReturns merge requests with the given source project id
target_branchstringNoReturns merge requests with the given target branch
searchstringNoSearch merge requests against their title and description.
instringNoModify the scope of the search attribute. title, description, or a string joining them with comma.
wipstringNoDeprecated. Use draft instead. Filter merge requests against their wip status. yes to return only draft merge requests, no to return non-draft merge requests.
draftbooleanNoFilter merge requests against their draft status. true to return only draft merge requests, false to return non-draft merge requests.
not[author_id]integerNo<Negated> Returns merge requests created by the given user id. Mutually exclusive with author_username. Combine with scope=all or scope=assigned_to_me.
not[author_username]stringNo<Negated> Returns merge requests created by the given username. Mutually exclusive with author_id.
not[assignee_id]integerNo<Negated> Returns merge requests assigned to the given user id. None returns unassigned merge requests. Any returns merge requests with an assignee.
not[assignee_username]string[]No<Negated> Returns merge requests created by the given username. Mutually exclusive with author_id.
not[reviewer_username]stringNo<Negated> 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. Introduced in GitLab 13.8.
not[labels]string[]No<Negated> 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.
not[milestone]stringNo<Negated> Returns merge requests for a specific milestone. None returns merge requests with no milestone. Any returns merge requests that have an assigned milestone.
not[my_reaction_emoji]stringNo<Negated> 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.
not[reviewer_id]integerNo<Negated> 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.
deployed_beforestringNoReturns merge requests deployed before the given date/time. Expected in ISO 8601 format.
deployed_afterstringNoReturns merge requests deployed after the given date/time. Expected in ISO 8601 format
environmentstringNoReturns merge requests deployed to the given environment
merge_user_idintegerNoReturns merge requests which have been merged by the user with the given user id. Mutually exclusive with merge_user_username.
merge_user_usernamestringNoReturns merge requests which have been merged by the user with the given username. Mutually exclusive with merge_user_id.
approver_idsstringNoReturn merge requests which have specified the users with the given IDs as an individual approver
approved_by_idsstringNoReturn merge requests which have been approved by the specified users with the given IDs
approved_by_usernamesstringNoReturn merge requests which have been approved by the specified users with the given usernames
pageintegerNoCurrent page number
per_pageintegerNoNumber of items per page
non_archivedbooleanNoReturns merge requests from non archived projects only.

gitlab_issues_list_project_issues

Get a list of project issues Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project
with_labels_detailsbooleanNoReturn titles of labels and other details
statestringNoReturn opened, closed, or all issues
closed_by_idintegerNoReturn issues which were closed by the user with the given ID.
order_bystringNoReturn issues ordered by created_at, due_date, label_priority, milestone_due, popularity, priority, relative_position, title, or updated_at fields.
sortstringNoReturn issues sorted in asc or desc order.
due_datestringNoReturn issues that have no due date (0), or whose due date is this week, this month, between two weeks ago and next month, or which are overdue. Accepts: overdue, week, month, next_month_and_previous_two_weeks, 0
issue_typestringNoThe type of the issue. Accepts: issue, incident, test_case, requirement, task, ticket
labelsstring[]NoComma-separated list of label names
milestonestringNoMilestone title
milestone_idstringNoReturn issues assigned to milestones with the specified timebox value (“Any”, “None”, “Upcoming” or “Started”)
iidsinteger[]NoThe IID array of issues
searchstringNoSearch issues for text present in the title, description, or any combination of these
instringNotitle, description, or a string joining them with comma
author_idintegerNoReturn issues which are authored by the user with the given ID
author_usernamestringNoReturn issues which are authored by the user with the given username
assignee_idintegerNoReturn issues which are assigned to the user with the given ID
assignee_usernamestring[]NoReturn issues which are assigned to the user with the given username
created_afterstringNoReturn issues created after the specified time
created_beforestringNoReturn issues created before the specified time
updated_afterstringNoReturn issues updated after the specified time
updated_beforestringNoReturn issues updated before the specified time
not[labels]string[]NoComma-separated list of label names
not[milestone]stringNoMilestone title
not[milestone_id]stringNoReturn issues assigned to milestones without the specified timebox value (“Any”, “None”, “Upcoming” or “Started”)
not[iids]integer[]NoThe IID array of issues
not[author_id]integerNoReturn issues which are not authored by the user with the given ID
not[author_username]stringNoReturn issues which are not authored by the user with the given username
not[assignee_id]integerNoReturn issues which are not assigned to the user with the given ID
not[assignee_username]string[]NoReturn issues which are not assigned to the user with the given username
not[weight]integerNoReturn issues without the specified weight
not[iteration_id]integerNoReturn issues which are not assigned to the iteration with the given ID
not[iteration_title]stringNoReturn issues which are not assigned to the iteration with the given title
scopestringNoReturn issues for the given scope: created_by_me, assigned_to_me or all
my_reaction_emojistringNoReturn issues reacted by the authenticated user by the given emoji
confidentialbooleanNoFilter confidential or public issues
weightintegerNoThe weight of the issue
epic_idintegerNoThe ID of an epic associated with the issues
health_statusstringNoThe health status of the issue. Must be one of: on_track, needs_attention, at_risk, none, any
iteration_idintegerNoReturn issues which are assigned to the iteration with the given ID
iteration_titlestringNoReturn issues which are assigned to the iteration with the given title
pageintegerNoCurrent page number
per_pageintegerNoNumber of items per page
cursorstringNoCursor for obtaining the next set of records

gitlab_issues_list_project_merge_requests

List project merge requests Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project.
author_idintegerNoReturns merge requests created by the given user id. Mutually exclusive with author_username. Combine with scope=all or scope=assigned_to_me.
author_usernamestringNoReturns merge requests created by the given username. Mutually exclusive with author_id.
assignee_idintegerNoReturns merge requests assigned to the given user id. None returns unassigned merge requests. Any returns merge requests with an assignee.
assignee_usernamestring[]NoReturns merge requests created by the given username. Mutually exclusive with author_id.
reviewer_usernamestringNoReturns 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. Introduced in GitLab 13.8.
labelsstring[]NoReturns 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.
milestonestringNoReturns merge requests for a specific milestone. None returns merge requests with no milestone. Any returns merge requests that have an assigned milestone.
my_reaction_emojistringNoReturns 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_idintegerNoReturns 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.
statestringNoReturns all merge requests or just those that are opened, closed, locked, or merged.
order_bystringNoReturns merge requests ordered by created_at, label_priority, milestone_due, popularity, priority, title, updated_at or merged_at fields. Introduced in GitLab 14.8.
sortstringNoReturns merge requests sorted in asc or desc order.
with_labels_detailsbooleanNoIf true, response returns more details for each label in labels field: :name,:color, :description, :description_html, :text_color
with_merge_status_recheckbooleanNoIf true, this projection requests (but does not guarantee) that the merge_status field be recalculated asynchronously. Introduced in GitLab 13.0.
created_afterstringNoReturns merge requests created on or after the given time. Expected in ISO 8601 format.
created_beforestringNoReturns merge requests created on or before the given time. Expected in ISO 8601 format.
updated_afterstringNoReturns merge requests updated on or after the given time. Expected in ISO 8601 format.
updated_beforestringNoReturns merge requests updated on or before the given time. Expected in ISO 8601 format.
viewstringNoIf simple, returns the iid, URL, title, description, and basic state of merge request
scopestringNoReturns merge requests for the given scope: created_by_me, assigned_to_me, reviews_for_me or all
source_branchstringNoReturns merge requests with the given source branch
source_project_idintegerNoReturns merge requests with the given source project id
target_branchstringNoReturns merge requests with the given target branch
searchstringNoSearch merge requests against their title and description.
instringNoModify the scope of the search attribute. title, description, or a string joining them with comma.
wipstringNoDeprecated. Use draft instead. Filter merge requests against their wip status. yes to return only draft merge requests, no to return non-draft merge requests.
draftbooleanNoFilter merge requests against their draft status. true to return only draft merge requests, false to return non-draft merge requests.
not[author_id]integerNo<Negated> Returns merge requests created by the given user id. Mutually exclusive with author_username. Combine with scope=all or scope=assigned_to_me.
not[author_username]stringNo<Negated> Returns merge requests created by the given username. Mutually exclusive with author_id.
not[assignee_id]integerNo<Negated> Returns merge requests assigned to the given user id. None returns unassigned merge requests. Any returns merge requests with an assignee.
not[assignee_username]string[]No<Negated> Returns merge requests created by the given username. Mutually exclusive with author_id.
not[reviewer_username]stringNo<Negated> 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. Introduced in GitLab 13.8.
not[labels]string[]No<Negated> 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.
not[milestone]stringNo<Negated> Returns merge requests for a specific milestone. None returns merge requests with no milestone. Any returns merge requests that have an assigned milestone.
not[my_reaction_emoji]stringNo<Negated> 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.
not[reviewer_id]integerNo<Negated> 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.
deployed_beforestringNoReturns merge requests deployed before the given date/time. Expected in ISO 8601 format.
deployed_afterstringNoReturns merge requests deployed after the given date/time. Expected in ISO 8601 format
environmentstringNoReturns merge requests deployed to the given environment
merge_user_idintegerNoReturns merge requests which have been merged by the user with the given user id. Mutually exclusive with merge_user_username.
merge_user_usernamestringNoReturns merge requests which have been merged by the user with the given username. Mutually exclusive with merge_user_id.
approver_idsstringNoReturn merge requests which have specified the users with the given IDs as an individual approver
approved_by_idsstringNoReturn merge requests which have been approved by the specified users with the given IDs
approved_by_usernamesstringNoReturn merge requests which have been approved by the specified users with the given usernames
pageintegerNoCurrent page number
per_pageintegerNoNumber of items per page
iidsinteger[]NoReturns the request having the given iid.

gitlab_issues_merge_merge_request

Merge a merge request Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project.
merge_request_iidintegerYesMerge Request Iid
auto_mergebooleanNoIf true, the merge request is set to auto merge.
merge_commit_messagestringNoCustom merge commit message.
merge_when_pipeline_succeedsbooleanNoDeprecated: Use auto_merge instead.
shastringNoIf present, then this SHA must match the HEAD of the source branch, otherwise the merge fails.
should_remove_source_branchbooleanNoIf true, removes the source branch.
skip_merge_trainbooleanNoIf true skips train restart when merging immediately in a merge train configured project.
squashbooleanNoIf true, the commits are squashed into a single commit on merge.
squash_commit_messagestringNoCustom squash commit message.

Search an instance Parameters:
ParameterTypeRequiredDefaultDescription
searchstringYesThe expression it should be searched for
scopestringYesThe scope of the search
statestringNoFilter results by state
confidentialbooleanNoFilter results by confidentiality
typestring[]NoFilter work items by type. Only applies to work_items scope. Available types: issue, task, epic, incident, test_case, requirement, objective, key_result, ticket.
include_archivedbooleanNoIncludes archived projects in the search. Introduced in GitLab 18.9.
fieldsstring[]NoArray of fields you wish to search. Available with advanced search.
exclude_forksbooleanNoExcludes forked projects in the search. Available with exact code search. Introduced in GitLab 18.9.
num_context_linesintegerNoNumber of context lines around each match. Available with advanced and exact code search. Introduced in GitLab 18.11.
regexbooleanNoPerforms a regex code search. Available with exact code search. Introduced in GitLab 18.9
pageintegerNoCurrent page number
per_pageintegerNoNumber of items per page

gitlab_issues_update_issue

Update an existing issue Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project
issue_iidintegerYesThe internal ID of a project issue
add_labelsstring[]NoComma-separated list of label names
assignee_idintegerNo[Deprecated] The ID of a user to assign issue
assignee_idsinteger[]NoThe array of user IDs to assign issue
confidentialbooleanNoBoolean parameter if the issue should be confidential
created_atstringNoCreated At
descriptionstringNoThe description of an issue
discussion_lockedbooleanNoBoolean parameter indicating if the issue’s discussion is locked
due_datestringNoDate string in the format YEAR-MONTH-DAY
epic_idintegerNoThe ID of an epic to associate the issue with
epic_iidintegerNoThe IID of an epic to associate the issue with (deprecated)
issue_typestringNoThe type of the issue. Accepts: issue, incident, test_case, requirement, task, ticket
labelsstring[]NoComma-separated list of label names
milestonestringNoThe title of a project or ancestor-group milestone to assign the issue to. Mutually exclusive with milestone_id.
milestone_idintegerNoThe ID of a milestone to assign issue
remove_labelsstring[]NoComma-separated list of label names
state_eventstringNoState of the issue
titlestringNoThe title of an issue
updated_atstringNoDate time when the issue was updated. Available only for admins and project owners.
weightintegerNoThe weight of the issue

gitlab_issues_update_merge_request

Update merge request Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID or URL-encoded path of the project.
merge_request_iidintegerYesMerge Request Iid
add_labelsstring[]NoComma-separated label names to add to a merge request.
allow_collaborationbooleanNoAllow commits from members who can merge to the target branch.
allow_maintainer_to_pushbooleanNo[deprecated] See allow_collaboration
approvals_before_mergeintegerNoNumber of approvals required before this can be merged
assignee_idintegerNoAssignee user ID.
assignee_idsinteger[]NoThe IDs of the users to assign the merge request to, as a comma-separated list. Set to 0 or provide an empty value to unassign all assignees.
descriptionstringNoDescription of the merge request. Limited to 1,048,576 characters.
discussion_lockedbooleanNoFlag indicating if the merge request’s discussion is locked. If the discussion is locked only project members can add, edit or resolve comments.
labelsstring[]NoComma-separated label names for a merge request. Set to an empty string to unassign all labels.
merge_afterstringNoDate after which the merge request can be merged.
milestonestringNoThe title of a project or ancestor-group milestone to assign the merge request to. Mutually exclusive with milestone_id.
milestone_idintegerNoThe global ID of a milestone to assign the merge request to.
remove_labelsstring[]NoComma-separated label names to remove from a merge request.
remove_source_branchbooleanNoFlag indicating if a merge request should remove the source branch when merging.
reviewer_idsinteger[]NoThe IDs of the users to review the merge request, as a comma-separated list. Set to 0 or provide an empty value to unassign all reviewers.
squashbooleanNoSquash commits into a single commit when merging.
state_eventstringNoNew state (close/reopen).
target_branchstringNoThe target branch.
titlestringNoThe title of the merge request.