GitLab

gitlab

A web-based DevOps lifecycle tool that provides a Git repository manager providing wiki, issue-tracking, and CI/CD pipeline features.

Developer Tools Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Sí

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (54)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Archive ProjectGITLAB_ARCHIVE_PROJECTAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project to archive.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create GitLab GroupGITLAB_CREATE_GROUPAcción

Tool to create a new group in gitlab. use when you need to establish a new group for projects or collaboration.

Parámetros de entrada

namestringObligatorio
The name of the group.
pathstringObligatorio
The path of the group.
avatarstring
Image file for avatar of the group.
parent_idinteger
The parent group ID for creating nested group.
visibilitystringenum
The group’s visibility.
privateinternalpublic
descriptionstring
The group’s description.
lfs_enabledboolean
Enable/disable Large File Storage (LFS) for the projects in this group.
default_branchstring
The default branch name for group’s projects.
emails_enabledboolean
Enable email notifications.
membership_lockboolean
Users cannot be added to projects in this group. Premium and Ultimate only.
organization_idinteger
The organization ID for the group.
duo_availabilitystringenum
Duo availability setting. Note: In the UI, never_on is displayed as "Always Off".
default_ondefault_offnever_on
mentions_disabledboolean
Disable the capability of a group from getting mentioned.
wiki_access_levelstringenum
The wiki access level. Premium and Ultimate only.
disabledprivateenabled
auto_devops_enabledboolean
Default to Auto DevOps pipeline for all projects within this group.
share_with_group_lockboolean
Prevent sharing a project with another group within this group.
project_creation_levelstringenum
Determine if developers can create projects in the group.
administratornoonemaintainerdeveloper
request_access_enabledboolean
Allow users to request member access.
subgroup_creation_levelstringenum
Allowed to create subgroups.
ownermaintainer
two_factor_grace_periodinteger
Time before Two-factor authentication is enforced (in hours).
enabled_git_access_protocolstringenum
Enabled protocols for Git access.
sshhttpall
experiment_features_enabledboolean
Enable experiment features for this group.
shared_runners_minutes_limitinteger
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_authenticationboolean
Require all users in this group to set up two-factor authentication.
default_branch_protection_defaultsobject
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_limitinteger
Can be set by administrators only. Additional compute minutes for this group. GitLab Self-Managed, Premium and Ultimate only.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create ProjectGITLAB_CREATE_PROJECTAcción

Tool to create a new project in gitlab. implements post /projects endpoint.

Parámetros de entrada

namestringObligatorio
The name of the project.
pathstringObligatorio
The path or URL-friendly name for the project.
visibilitystringenum
Project visibility.
privateinternalpublic
descriptionstring
Project description.
namespace_idinteger
The namespace (group or user ID) under which to create the project.
wiki_enabledboolean
Enable wiki feature.
default_branchstring
The default branch name.
issues_enabledboolean
Enable issues feature.
snippets_enabledboolean
Enable snippets feature.
build_git_strategystring
Git strategy for builds.
merge_requests_enabledboolean
Enable merge requests feature.
container_registry_enabledboolean
Enable container registry.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Project IssueGITLAB_CREATE_PROJECT_ISSUEAcción

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.

Parámetros de entrada

idstringObligatorio
The global ID or URL-encoded path of the project.
iidinteger
The internal ID of the project’s issue (requires administrator or project owner rights).
titlestringObligatorio
The title of an issue.
labelsstring
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.
weightinteger
The weight of the issue. Valid values are greater than or equal to 0. Premium and Ultimate only.
epic_idinteger
ID of the epic to add the issue to. Valid values are greater than or equal to 0. Premium and Ultimate only.
due_datestring
The due date. Date time string in the format `YYYY-MM-DD`, for example `2016-03-11`.
epic_iidinteger
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_atstring
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_typestringenum
The type of issue. One of `issue`, `incident`, `test_case` or `task`. Default is `issue`.
issueincidenttest_casetask
assignee_idinteger
The ID of the user to assign the issue to. Only appears on GitLab Free.
descriptionstring
The description of an issue. Limited to 1,048,576 characters.
assignee_idsinteger[]
The IDs of the users to assign the issue to. Premium and Ultimate only.
confidentialboolean
Set an issue to be confidential. Default is false.
milestone_idinteger
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_resolvestring
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_ofinteger
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.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Repository BranchGITLAB_CREATE_REPOSITORY_BRANCHAcción

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.

Parámetros de entrada

refstringObligatorio
The branch name or commit SHA to create the new branch from.
project_idintegerObligatorio
The ID or URL-encoded path of the project.
branch_namestringObligatorio
The name of the new branch.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete ProjectGITLAB_DELETE_PROJECTAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project to be deleted.
full_pathstring
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_removeboolean
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).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Download Project AvatarGITLAB_DOWNLOAD_PROJECT_AVATARAcción

Tool to download a project’s avatar image. use when you need the raw avatar bytes after confirming the project exists.

Parámetros de entrada

idstringObligatorio
The ID or URL-encoded path of the project whose avatar to download.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Erase JobGITLAB_ERASE_JOBAcción

Tool to erase the content of a specified job within a project. use when you need to remove job artifacts and logs.

Parámetros de entrada

job_idintegerObligatorio
The ID of the job to be erased.
project_idintegerObligatorio
The ID or URL-encoded path of the project.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Commit ReferencesGITLAB_GET_COMMIT_REFSAcción

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.

Parámetros de entrada

shastringObligatorio
The commit hash.
ref_typestringenum
The scope of commits to list. Possible values are `branch`, `tag`, or `all`.
branchtagall
project_idintegerObligatorio
The ID or URL-encoded path of the project.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Commit SequenceGITLAB_GET_COMMIT_SEQUENCEAcción

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.

Parámetros de entrada

shastringObligatorio
The commit hash.
project_idintegerObligatorio
The ID or URL-encoded path of the project.
first_parentboolean
Follow only the first parent commit upon seeing a merge commit.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Group DetailsGITLAB_GET_GROUPAcción

Tool to retrieve information about a specific group by its id. use when you need to get details of a gitlab group.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the group.
with_projectsboolean
Include details from projects that belong to the specified group (defaults to true). Deprecated, scheduled for removal in API v5.
with_custom_attributesboolean
Include custom attributes in response (administrators only).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Group MemberGITLAB_GET_GROUP_MEMBERAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the group.
user_idintegerObligatorio
The user ID of the group member to retrieve.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get GroupsGITLAB_GET_GROUPSAcción

Get groups

Parámetros de entrada

pageinteger
Page number for pagination.
sortstringenum
Return groups sorted in 'asc' or 'desc' order.
ascdesc
ownedboolean
Limit to groups owned by the current user.
searchstring
Search for groups by name or path.
order_bystringenum
Return groups ordered by this field.
idnamepathcreated_atupdated_at
per_pageinteger
Number of results per page.
statisticsboolean
Include group statistics (admin only).
all_availableboolean
Include all groups the user has access to (admin only).
skip_groups[]integer[]
List of group IDs to exclude.
with_projectsboolean
Include project details in response (deprecated).
with_two_factorboolean
Include groups requiring two-factor authentication.
min_access_levelinteger
Limit to groups with minimum access level.
with_custom_attributesboolean
Include custom attributes in response (admins only).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Job DetailsGITLAB_GET_JOB_DETAILSAcción

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.

Parámetros de entrada

job_idintegerObligatorio
The ID of the job.
project_idintegerObligatorio
The ID or URL-encoded path of the project.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Merge Request NotesGITLAB_GET_MERGE_REQUEST_NOTESAcción

Tool to fetch comments on a merge request. use when you need to retrieve all notes for a specific merge request.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
pageinteger
Page number to retrieve.
per_pageinteger
Number of notes per page (max 100).
merge_request_iidintegerObligatorio
Internal ID of the merge request.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get ProjectGITLAB_GET_PROJECTAcción

Tool to get a single project by id or url-encoded path.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Project LanguagesGITLAB_GET_PROJECT_LANGUAGESAcción

Tool to list programming languages used in a project with percentages. use when you need the project language breakdown.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Project MemberGITLAB_GET_PROJECT_MEMBERAcción

Tool to retrieve details for a specific project member. use after confirming project and user ids to fetch membership information for a project member.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
user_idintegerObligatorio
The user ID of the project member to retrieve.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Project Member AllGITLAB_GET_PROJECT_MEMBER_ALLAcción

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).

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
user_idintegerObligatorio
The user ID of the project member.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Merge Request CommitsGITLAB_GET_PROJECT_MERGE_REQUEST_COMMITSAcción

Tool to get commits of a merge request. use when you need to retrieve all commits associated with a specific merge request.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
merge_request_iidintegerObligatorio
Internal ID of the merge request.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Project Merge RequestsGITLAB_GET_PROJECT_MERGE_REQUESTSAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
wipstring
Filter merge requests against their wip status. Use yes to return only draft merge requests, no to return non-draft merge requests.
pageinteger
The page of results to return. Defaults to 1.
sortstring
Returns requests sorted in asc or desc order. Default is desc.
viewstring
If simple, returns the iid, URL, title, description, and basic state of merge request.
scopestring
Returns merge requests for the given scope: created_by_me, assigned_to_me or all. Defaults to created_by_me.
statestring
Returns all merge requests or just those that are opened, closed, locked, or merged.
iids[]integer[]
Returns the request having the given iid.
labelsstring
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.
searchstring
Search merge requests against their title and description.
approvedstring
Filters merge requests by their approved status. yes returns only approved merge requests. no returns only non-approved merge requests. Requires the mr_approved_filter feature flag, disabled by default.
order_bystring
Returns requests ordered by created_at, title, merged_at, or updated_at fields. Default is created_at.
per_pageinteger
The number of results per page. Defaults to 20.
author_idinteger
Returns merge requests created by the given user id. Mutually exclusive with author_username. Combine with scope=all or scope=assigned_to_me.
milestonestring
Returns merge requests for a specific milestone. None returns merge requests with no milestone. Any returns merge requests that have an assigned milestone.
not_filterobject
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_idinteger
Returns merge requests assigned to the given user id. None returns unassigned merge requests. Any returns merge requests with an assignee.
environmentstring
Returns merge requests deployed to the given environment.
reviewer_idinteger
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_idsinteger[]
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_afterstringdate-time
Returns merge requests created on or after the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
merge_user_idinteger
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_branchstring
Returns merge requests with the given source branch.
target_branchstring
Returns merge requests with the given target branch.
updated_afterstringdate-time
Returns merge requests updated on or after the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
created_beforestringdate-time
Returns merge requests created on or before the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
deployed_afterstringdate-time
Returns merge requests deployed after the given date/time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
updated_beforestringdate-time
Returns merge requests updated on or before the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
approved_by_idsinteger[]
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_usernamestring
Returns merge requests created by the given username. Mutually exclusive with author_id.
deployed_beforestringdate-time
Returns merge requests deployed before the given date/time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
my_reaction_emojistring
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_usernamestring
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_usernamestring
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_detailsboolean
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_recheckboolean
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.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get ProjectsGITLAB_GET_PROJECTSAcción

Tool to list all projects accessible to the authenticated user. supports filtering.

Parámetros de entrada

pageinteger
Page number for pagination.
sortstringenum
Return projects sorted in 'asc' or 'desc' order. Default is 'desc'.
ascdesc
ownedboolean
Limit by projects explicitly owned by the current user.
searchstring
Return list of projects matching search criteria (case-insensitive substring).
simpleboolean
Return only limited fields for each project.
starredboolean
Limit by projects starred by the current user.
archivedboolean
Limit by archived status.
id_afterinteger
Limit results to projects with IDs greater than the specified ID.
order_bystringenum
Return projects ordered by this field. Default is 'created_at'.
idnamepathcreated_atupdated_atstar_countlast_activity_at
per_pageinteger
Number of items per page (1-100).
id_beforeinteger
Limit results to projects with IDs less than the specified ID.
membershipboolean
Limit by projects that the current user is a member of.
statisticsboolean
Include project statistics. Available to Reporter role and above.
visibilitystringenum
Limit by project visibility.
privateinternalpublic
min_access_levelinteger
Limit by current user minimal role (access_level).
with_issues_enabledboolean
Limit by enabled issues feature.
with_custom_attributesboolean
Include custom attributes in response (admin only).
with_programming_languagestring
Limit by projects which use the given programming language.
with_merge_requests_enabledboolean
Limit by enabled merge requests feature.

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Merge Request DiffsGITLAB_GET_PROJECTS_ID_MERGE_REQUESTS_IID_DIFFSAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
merge_request_iidintegerObligatorio
The internal ID of the merge request.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Repository BranchGITLAB_GET_REPOSITORY_BRANCHAcción

Tool to retrieve information about a specific branch in a project. use when you need to get details for a single branch.

Parámetros de entrada

project_idintegerObligatorio
The ID or URL-encoded path of the project.
branch_namestringObligatorio
The URL-encoded name of the branch.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Repository BranchesGITLAB_GET_REPOSITORY_BRANCHESAcción

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.

Parámetros de entrada

regexstring
Return list of branches with names matching a re2 regular expression.
searchstring
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_idintegerObligatorio
The ID or URL-encoded path of the project.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Single CommitGITLAB_GET_SINGLE_COMMITAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
shastringObligatorio
The commit hash or name of a repository branch or tag.
statsboolean
Include commit stats. Default is true.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Single PipelineGITLAB_GET_SINGLE_PIPELINEAcción

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.

Parámetros de entrada

project_idintegerObligatorio
The ID or URL-encoded path of the project.
pipeline_idintegerObligatorio
The ID of the pipeline.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get UserGITLAB_GET_USERAcción

Tool to retrieve information about a specific user by their id. use when you need to fetch details for a single gitlab user.

Parámetros de entrada

idintegerObligatorio
The ID of the user.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get User PreferencesGITLAB_GET_USER_PREFERENCESAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get UsersGITLAB_GET_USERSAcción

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.

Parámetros de entrada

pageinteger
Page number for pagination.
sortstringenum
Return users sorted in 'asc' or 'desc' order. Default is 'desc'. (Admin only)
ascdesc
activeboolean
Filters only active users. Default is false.
adminsboolean
Return only administrators. Default is false. (Admin only)
humansboolean
Filters only regular users that are not bot or internal users. Default is false.
searchstring
Search for users by name, username, or public email.
blockedboolean
Filters only blocked users. Default is false.
auditorsboolean
Return only auditor users. Default is false. If not included, it returns all users. (Admin only, Premium and Ultimate only)
externalboolean
Filters only external users. Default is false.
order_bystringenum
Return users ordered by 'id', 'name', 'username', 'created_at', or 'updated_at' fields. Default is 'id'. (Admin only)
idnameusernamecreated_atupdated_at
per_pageinteger
Number of items per page for pagination.
providerstring
The external provider. (Admin only)
usernamestring
Get a single user with a specific username.
skip_ldapboolean
Skip LDAP users. (Admin only, Premium and Ultimate only)
extern_uidstring
Get a single user with a specific external authentication provider UID. (Admin only)
two_factorstringenum
Filter users by Two-factor authentication. Filter values are 'enabled' or 'disabled'. (Admin only)
enableddisabled
created_afterstringdate-time
Return users created after specified time (ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ).
created_beforestringdate-time
Return users created before specified time (ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ).
exclude_activeboolean
Filters only non active users. Default is false.
exclude_humansboolean
Filters only bot or internal users. Default is false.
exclude_externalboolean
Filters only non external users. Default is false.
exclude_internalboolean
Filters only non internal users. Default is false.
without_projectsboolean
Filter users without projects. Default is false. (Admin only)
without_project_botsboolean
Filters user without project bots. Default is false.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get User StatusGITLAB_GET_USERS_ID_STATUSAcción

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.

Parámetros de entrada

user_idintegerObligatorio
The numeric ID of the GitLab user whose status you want to retrieve.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get User StatusGITLAB_GET_USER_STATUSAcción

Tool to get the current user's status. use when displaying or verifying the authenticated user's gitlab status after login.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get User Support PINGITLAB_GET_USER_SUPPORT_PINAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Import project membersGITLAB_IMPORT_PROJECT_MEMBERSAcción

Tool to import members from one project to another. use when migrating members between projects.

Parámetros de entrada

idstringObligatorio
ID or URL-encoded path of the target project to receive members.
project_idstringObligatorio
ID or URL-encoded path of the source project to import members from.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List All Group MembersGITLAB_LIST_ALL_GROUP_MEMBERSAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the group.
pageinteger
Page number for pagination.
per_pageinteger
Number of items per page for pagination.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List All Project MembersGITLAB_LIST_ALL_PROJECT_MEMBERSAcción

Tool to list all members of a project (direct, inherited, invited). use when you need the effective membership list including inherited and invited members.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
pageinteger
Page number for pagination.
querystring
Filters results based on a given name, email, or username. Use partial values to widen the scope of the query.
statestringenum
Filter results by member state, one of 'awaiting' or 'active'. Premium and Ultimate only.
awaitingactive
per_pageinteger
Number of items per page for pagination.
user_idsinteger[]
Filter the results on the given user IDs.
show_seat_infoboolean
Show seat information for users.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Billable Group MembersGITLAB_LIST_BILLABLE_GROUP_MEMBERSAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the top-level group. Only top-level groups are supported.
pageinteger
Page number for pagination (must be ≥ 1).
sortstringenum
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.
access_level_ascaccess_level_desclast_joinedname_ascname_descoldest_joinedoldest_sign_inrecent_sign_inlast_activity_on_asclast_activity_on_desc
searchstring
Search string to filter members by name, username, or public email.
per_pageinteger
Number of items per page for pagination (must be ≥ 1).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Group MembersGITLAB_LIST_GROUP_MEMBERSAcción

Tool to list direct members of a group. use when you need to retrieve or filter a group's direct membership.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the group.
pageinteger
Page number for pagination.
sortstringenum
Order results by access level, ascending or descending.
access_level_ascaccess_level_desc
querystring
Filter members by name, username, or email substring.
activeboolean
When true, return only active users.
per_pageinteger
Number of results per page (1–100).
relationsstring[]
Membership relation types to include: direct, descendants, inherited, or shared.
skip_usersinteger[]
List of user IDs to exclude from the results.
two_factorstringenum
Filter users by two-factor authentication status.
enableddisabled
include_inheritedboolean
Include members inherited from ancestor groups when true.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Pending Group MembersGITLAB_LIST_PENDING_GROUP_MEMBERSAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the top-level group.
pageinteger
Page number for pagination (1-based index).
per_pageinteger
Number of items per page for pagination (max 100).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Pipeline JobsGITLAB_LIST_PIPELINE_JOBSAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
scopestringenum
The scope of jobs to show. Can be a single status or a list of statuses. If not provided, all jobs are returned.
canceledcancelingcreatedfailedmanualpendingpreparingrunningscheduledskippedsuccesswaiting_for_resource
pipeline_idintegerObligatorio
The ID of the pipeline.
include_retriedboolean
Include retried jobs in the response. Defaults to false.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Project GroupsGITLAB_LIST_PROJECT_GROUPSAcción

Tool to list ancestor groups of a project. use when you need to retrieve all groups a project belongs to or is shared with.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
pageinteger
Page number of the results to retrieve.
searchstring
Search for specific groups by name.
per_pageinteger
Number of items to return per page.
skip_groupsinteger[]
Skip the group IDs passed.
with_sharedboolean
Include projects shared with this group. Default is false.
shared_visible_onlyboolean
Limit to shared groups user has access to.
shared_min_access_levelinteger
Limit to shared groups with at least this access level.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Project Invited GroupsGITLAB_LIST_PROJECT_INVITED_GROUPSAcción

Tool to list groups invited to a project. use when auditing which groups have access to a project.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
pageinteger
Page number for pagination.
per_pageinteger
Number of items to return per page.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Project PipelinesGITLAB_LIST_PROJECT_PIPELINESAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
refstring
The ref of pipelines.
shastring
The SHA of pipelines.
namestring
Return pipelines with the specified name.
pageinteger
Page number for pagination.
sortstringenum
Sort pipelines in 'asc' or 'desc' order.
ascdesc
scopestringenum
The scope of pipelines, one of: 'running', 'pending', 'finished', 'branches', 'tags'.
runningpendingfinishedbranchestags
sourcestring
The pipeline source. To return child pipelines, set to 'parent_pipeline'.
statusstringenum
The status of pipelines.
createdwaiting_for_resourcepreparingpendingrunningsuccessfailedcanceledskippedmanualscheduled
order_bystringenum
Order pipelines by 'id', 'status', 'ref', 'updated_at' or 'user_id'.
idstatusrefupdated_atuser_id
per_pageinteger
Number of items per page for pagination.
usernamestring
The username of the user who triggered pipelines.
yaml_errorsboolean
Returns pipelines with invalid configurations.
created_afterstringdate-time
Return pipelines created after the specified date (ISO 8601 format).
updated_afterstringdate-time
Return pipelines updated after the specified date (ISO 8601 format).
created_beforestringdate-time
Return pipelines created before the specified date (ISO 8601 format).
updated_beforestringdate-time
Return pipelines updated before the specified date (ISO 8601 format).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Project Shareable GroupsGITLAB_LIST_PROJECT_SHAREABLE_GROUPSAcción

Tool to list groups that can be shared with a project. use before sharing a project to fetch eligible groups.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
pageinteger
Page number for pagination.
searchstring
Search term to filter groups by name or path.
per_pageinteger
Number of items per page for pagination.
skip_groupsinteger[]
List of group IDs to exclude from the results.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Project Repository TagsGITLAB_LIST_PROJECT_TAGSAcción

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.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
pageinteger
Page number of the results to retrieve.
sortstring
Return tags sorted in `asc` or `desc` order. Default is `desc`.
searchstring
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_bystring
Return tags ordered by `name`, `updated`, or `version`. Default is `updated`.
per_pageinteger
Number of items to return per page.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Project Transfer LocationsGITLAB_LIST_PROJECT_TRANSFER_LOCATIONSAcción

Tool to list namespaces available for project transfer. use when you need to determine which groups a project can be transferred into.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
searchstring
The group names to search for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List project usersGITLAB_LIST_PROJECT_USERSAcción

Tool to list users of a project. use after you have a project id and want to retrieve its users.

Parámetros de entrada

idstringObligatorio
The ID or URL-encoded path of the project.
searchstring
Filter users by name or username.
skip_usersinteger[]
List of user IDs to exclude from the result.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Repository CommitsGITLAB_LIST_REPOSITORY_COMMITSAcción

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.

Parámetros de entrada

allboolean
Retrieve every commit from the repository. When set to true, the ref_name parameter is ignored.
pathstring
The file path to filter commits by.
orderstringenum
List commits in order. Possible values: default, topo. Defaults to default, the commits are shown in reverse chronological order.
defaulttopo
sincestring
Only commits after or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ.
untilstring
Only commits before or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ.
authorstring
Search commits by commit author.
ref_namestring
The name of a repository branch, tag or revision range, or if not given the default branch.
trailersboolean
Parse and include Git trailers for every commit.
project_idintegerObligatorio
The ID or URL-encoded path of the project.
with_statsboolean
Stats about each commit are added to the response.
first_parentboolean
Follow only the first parent commit upon seeing a merge commit.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List User ProjectsGITLAB_LIST_USER_PROJECTSAcción

Tool to list projects owned by a specific user. use after obtaining target user identity to fetch owned projects.

Parámetros de entrada

idintegerObligatorio
The ID or username of the user whose projects to list.
pageinteger
Page number for pagination.
sortstringenum
Return projects sorted in asc or desc order. Default is 'desc'.
ascdesc
ownedboolean
Limit by projects explicitly owned by the specified user.
searchstring
Return list of projects matching search criteria (case-insensitive substring).
simpleboolean
Return only limited fields for each project.
starredboolean
Limit by projects starred by the specified user.
archivedboolean
Limit by archived status.
id_afterinteger
Limit results to projects with IDs greater than the specified ID.
order_bystringenum
Return projects ordered by this field. Default is 'created_at'.
idnamepathcreated_atupdated_atstar_countlast_activity_at
per_pageinteger
Number of items per page (1-100).
id_beforeinteger
Limit results to projects with IDs less than the specified ID.
membershipboolean
Limit by projects that the current user is a member of.
statisticsboolean
Include project statistics. Available to Reporter role and above.
visibilitystringenum
Limit by project visibility.
privateinternalpublic
updated_afterstringdate-time
Limit projects updated after given time (ISO 8601).
updated_beforestringdate-time
Limit projects updated before given time (ISO 8601).
min_access_levelinteger
Limit by current user minimal role (access_level).
with_issues_enabledboolean
Limit by enabled issues feature.
with_custom_attributesboolean
Include custom attributes in response (admin only).
with_programming_languagestring
Limit by projects which use the given programming language.
with_merge_requests_enabledboolean
Limit by enabled merge requests feature.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Support PINGITLAB_POST_USER_SUPPORT_PINAcción

Tool to create a support pin for your authenticated user. use when gitlab support requests a pin to verify your identity.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update User PreferencesGITLAB_PUT_USER_PREFERENCESAcción

Tool to update the current user's preferences. use when adjusting default diff viewing and ci identity settings.

Parámetros de entrada

view_diffs_file_by_filebooleanObligatorio
Flag indicating the user sees only one file diff per page.
show_whitespace_in_diffsbooleanObligatorio
Flag indicating the user sees whitespace changes in diffs.
pass_user_identities_to_ci_jwtbooleanObligatorio
Flag indicating the user passes their external identities as CI information. Internal use only; do not expose to third-party services.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Set User StatusGITLAB_SET_USER_STATUSAcción

Tool to set the current user's status. use when you need to update availability or convey current mood on gitlab.

Parámetros de entrada

emojistring
Name of the emoji to use as status. Defaults to 'speech_balloon' if omitted.
messagestring
Status message to display. Max 100 characters; can contain emoji codes.
clear_status_afterstringenum
Automatically clear status after the specified time interval. Allowed values: 30_minutes, 3_hours, 8_hours, 1_day, 3_days, 7_days, 30_days.
30_minutes3_hours8_hours1_day3_days7_days30_days

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Share Project With GroupGITLAB_SHARE_PROJECT_WITH_GROUPAcción

Tool to share a project with a group. use when you need to grant a group specific access level to a project.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
group_idintegerObligatorio
The ID of the group to share with.
expires_atstring
Expiration date for the group share in YYYY-MM-DD format (ISO 8601).
group_accessintegerObligatorio
The access level to grant the group. One of GitLab's access levels, e.g., 30 for Developer, 40 for Maintainer.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Start Housekeeping TaskGITLAB_START_PROJECT_HOUSEKEEPINGAcción

Tool to start the housekeeping task for a project. use when you need to trigger manual maintenance or pruning on a repository.

Parámetros de entrada

idintegerObligatorio
The ID or URL-encoded path of the project.
taskstringenum
Type of housekeeping task to perform. `prune` triggers a manual prune of unreachable objects; `eager` triggers eager housekeeping.
pruneeager

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not