Skip to main content
GitLab logo
  • Category: developer tools
  • Auth: OAUTH2, API_KEY
  • Composio-managed OAuth available? Yes
  • Tools: 316
  • Triggers: 0
  • Slug: GITLAB
  • Version: 20261101_00

Frequently Asked Questions

For a step-by-step guide on creating and configuring your own GitLab OAuth credentials with Composio, see How to create OAuth credentials for GitLab.

Tools

Slug: GITLAB_ADD_GROUP_MEMBERAdd one or more direct group members by user ID or username. Billable role promotions may be queued for administrator approval rather than granted immediately.

Input Parameters

string
required
Group ID or unencoded group path.
string
User ID or comma-separated user IDs; required unless username is supplied.
string
Username or comma-separated usernames; required unless user_id is supplied.
string
Expiration date in YEAR-MONTH-DAY format.
integer ("5" | "10" | "15" | "20" | "25" | "30" | "40" | "50")
required
Guest 10, Planner 15, Reporter 20, Security Manager 25, Developer 30, Maintainer 40, Owner 50. Minimal access 5 requires a top-level group on Premium or Ultimate.
string
Source of the invitation that starts member creation.
integer
Custom member role ID (Ultimate only).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_ADD_PROJECT_MEMBERAdd one or more direct project members by user ID or username. Role promotions may be queued for administrator approval instead of granting membership immediately.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
User ID or comma-separated user IDs; required unless username is supplied.
string
Username or comma-separated usernames; required unless user_id is supplied.
string
Expiration date in YEAR-MONTH-DAY format.
integer ("10" | "15" | "20" | "25" | "30" | "40" | "50")
required
Access level: Guest 10, Planner 15, Reporter 20, Security Manager 25, Developer 30, Maintainer 40, Owner 50.
string
Source of the invitation that starts member creation.
integer
Custom member role ID (Ultimate only).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_ADD_SPENT_TIMEAdds spent time to a GitLab issue for time tracking purposes. This action logs time against an issue, accumulating with any previously logged time. Use this action when you need to record time spent working on an issue, track billable hours, or maintain project time logs.

Input Parameters

string
required
The global ID or URL-encoded path of the project.
string
A summary of how the time was spent.
string
required
The duration in human-readable format (e.g., ‘3h30m’, ‘1h’, ‘30m’, ‘1d’). Supports combinations of years (y), months (mo), weeks (w), days (d), hours (h), and minutes (m).
integer
required
The internal ID of the project’s issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_APPROVE_ALL_GROUP_MEMBERSApprove every pending user in a top-level group, its subgroups, and projects. Requires permission to activate group members and an api-scoped access token. This is a bulk access change that may consume paid seats. Review all pending memberships first; use only a group whose entire pending set is authorized for approval. For testing, use an isolated top-level group with disposable pending members, not an existing group’s unrelated pending memberships. See https://docs.gitlab.com/api/members/#approve-all-pending-group-members.

Input Parameters

string
required
ID or unencoded namespace path of the top-level group.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_APPROVE_DEPLOYMENTApprove or reject a deployment on GitLab Premium or Ultimate. See https://docs.gitlab.com/api/deployments/#approve-or-reject-a-deployment.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string ("approved" | "rejected")
required
Whether to approve or reject the deployment.
string
Comment to accompany the approval.
integer
required
ID of the deployment.
string
Name of the User/Group/Role to represent when you belong to multiple approval rules.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_APPROVE_GROUP_MEMBERApprove a pending member for a top-level group and its subgroups and projects. Requires the Owner role for the group. Members pending because the user cap was reached become billable after approval. This is not administrator approval of a role promotion. The operation documents no additional plan restriction. See https://docs.gitlab.com/api/members/#approve-a-group-member and https://docs.gitlab.com/user/group/manage/#approve-pending-members-for-a-group.

Input Parameters

string
required
ID or unencoded namespace path of the top-level group.
integer
required
ID of the pending member to approve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_APPROVE_MERGE_REQUESTApproves a merge request in a GitLab project. Use this action when you need to record an approval from the authenticated user on a specific merge request. The authenticated user must be an eligible approver with appropriate permissions. Note that this action is idempotent — calling it multiple times on the same merge request will not create duplicate approvals.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
HEAD commit SHA for validation. If provided, the approval will fail with 409 if the merge request HEAD does not match this SHA.
string
Current user’s password, required only if project settings enforce re-authentication for approvals.
integer
required
Internal ID of the merge request to approve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_ARCHIVE_PROJECTTool 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.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CANCEL_AUTO_MERGECancel active auto-merge and remove the merge request from its merge train. Requires GitLab 19.5 or later. Returns the merge request on HTTP 201; HTTP 403 means insufficient permission and 409 means auto-merge is not set. See https://docs.gitlab.com/api/merge_requests/#cancel-auto-merge.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
Project-local merge request IID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CANCEL_JOBCancel a GitLab CI/CD job within a specified project. This action stops a running or pending job and is irreversible. Use this action when you need to cancel a job that is running, pending, or stuck in a canceling state. The optional force parameter allows cancellation of jobs that are in a canceling state. Once canceled, the job cannot be restarted.

Input Parameters

boolean
Forces cancellation of a job in canceling state when set to true.
integer
required
The ID of the job to cancel.
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CANCEL_PIPELINETool to cancel a running pipeline in a GitLab project. Use this action when you need to stop a CI/CD pipeline that is currently executing or queued. Note that the API returns success (200) regardless of the pipeline’s state, so this action can be safely called even if the pipeline has already finished or been canceled.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The ID of the pipeline to cancel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CHERRY_PICK_COMMITCherry-pick a commit onto a project branch, creating a new commit. Set dry_run to true to check whether it applies cleanly without committing. Conflicts and empty changesets fail rather than creating a commit.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Hash of the commit to cherry-pick.
string
required
Name of the target branch.
boolean
If true, test applying the cherry-pick without committing changes. Defaults to false on GitLab.
string
Custom commit message for the new commit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CLONE_ISSUEClone an issue into a project, optionally including its notes. Copies as much data as possible when the destination has equivalent labels or milestones. Insufficient permissions can produce HTTP 400.

Input Parameters

string
required
ID or unencoded namespace path of the source project.
integer
required
Internal ID of the issue to clone.
boolean
Clone the issue with notes. GitLab defaults to false.
integer
required
ID of the destination project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_COMPARE_REPOSITORY_REFSCompare two branches, tags, or commit SHAs in a GitLab project.

Input Parameters

string
required
Ending branch, tag, or commit SHA.
boolean
Return diffs in unified diff format.
string
required
Starting branch, tag, or commit SHA.
boolean
Use a direct two-dot comparison instead of a merge-base comparison.
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
integer
Numeric ID of the project containing the starting ref.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_BOARD_LISTCreate one issue-board list by providing exactly one list selector.

Input Parameters

integer
required
The ID of the project issue board on which to create the list.
integer
The label ID for a label list. Provide exactly one list selector. Available on GitLab Free and higher tiers.
integer
The status ID for a status list. Provide exactly one list selector. Requires GitLab Premium or Ultimate.
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
integer
The user ID for an assignee list. Provide exactly one list selector. Requires GitLab Premium or Ultimate.
integer
The iteration ID for an iteration list. Provide exactly one list selector. Requires GitLab Premium or Ultimate.
integer
The milestone ID for a milestone list. Provide exactly one list selector. Requires GitLab Premium or Ultimate.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_COMMITCreates a commit in a GitLab project with multiple file operations, including creating, updating, deleting, moving, and changing permissions. An optional force setting can overwrite the target branch with a new commit history.

Input Parameters

boolean
When true, overwrites the target branch with a new commit history. Use with caution as this rewrites Git history.
boolean
Include commit statistics (additions, deletions, total) in the response. Defaults to true.
string
required
Target branch name where the commit will be created.
array
required
List of file operations to perform in this commit. Each action represents a file change (create, update, delete, move, or chmod).
string
SHA of the commit to start the new commit from. Must be a 40-character SHA-1 hash.
string
required
The ID or URL-encoded path of the project.
string
Author name for the commit. Defaults to the authenticated user’s name.
string
Author email address for the commit. Defaults to the authenticated user’s email.
string
Name of the branch to start the new commit from. If not provided, uses the target branch.
string
Project ID or URL-encoded path of the source project for the parent commit. Used when creating commits from another project’s branch.
string
required
The commit message describing the changes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_COMMIT_COMMENTPosts a comment to a specific commit in a GitLab project repository. Use this action when you need to provide feedback, review notes, or discussion on a particular commit. Line-specific comments require both path and line parameters; if invalid, the comment is placed at the commit level.

Input Parameters

string
required
The commit hash or name of a repository branch or tag.
integer
The line number where the comment should be placed. Requires path to be specified.
string
required
The text content of the comment.
string
The file path relative to the repository. Required if line or line_type is specified.
string
The type of line (‘new’ or ‘old’). Requires path and line to be specified.
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_DEPLOYMENTCreate a deployment for a project’s environment and deployed commit. See https://docs.gitlab.com/api/deployments/#create-a-deployment.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
required
Name of the deployed branch or tag.
string
required
SHA of the deployed commit.
boolean
required
Whether the deployed ref is a tag.
string ("running" | "success" | "failed" | "canceled")
required
Status of the deployment to create.
string
required
Name of the deployment environment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_ENVIRONMENTCreate an environment in a project, optionally associating Kubernetes resources. See https://docs.gitlab.com/api/environments/#create-an-environment.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
required
Name of the environment.
string ("production" | "staging" | "testing" | "development" | "other")
Deployment tier of the new environment.
string
Description of the environment.
string
URL to link to for this environment.
integer
Cluster agent ID to associate with this environment.
string ("always" | "with_action")
Whether to auto-stop always or only with a stop action.
string
Full Flux resource path, for example helm.toolkit.fluxcd.io/v2/namespaces/gitlab-agent/helmreleases/gitlab-agent.
string
Kubernetes namespace to associate with this environment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_FILECreates a new file in a GitLab repository at the specified path with the given content. Use this action when you need to add a new file to a repository branch with a commit message.

Input Parameters

string
required
The name of the branch where the file will be created.
string
required
The content of the file to create.
string
The encoding of the file content. Set to ‘base64’ if the content is base64-encoded. Default is ‘text’.
string
required
The full path to the file to create within the repository (e.g., ‘lib/class.rb’ or ‘docs/README.md’).
string
required
The ID or URL-encoded path of the project.
string
The name of the commit author. If not provided, uses the authenticated user’s name.
string
The email address of the commit author. If not provided, uses the authenticated user’s email.
string
Name of the base branch to create the new branch from. Only used if the specified branch does not exist.
string
required
The commit message describing why the file was created.
boolean
Whether to enable the execute flag on the file (for executable files).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_GROUPTool to create a new group in GitLab. Use when you need to establish a new group for projects or collaboration.

Input Parameters

string
required
The name of the group.
string
required
The path of the group.
string
Image file for avatar of the group.
integer
The parent group ID for creating nested group.
string ("private" | "internal" | "public")
The group’s visibility.
string
The group’s description.
boolean
Enable/disable Large File Storage (LFS) for the projects in this group.
string
The default branch name for group’s projects.
boolean
Enable email notifications.
boolean
Users cannot be added to projects in this group. Premium and Ultimate only.
integer
The organization ID for the group.
string ("default_on" | "default_off" | "never_on")
Duo availability setting. Note: In the UI, never_on is displayed as “Always Off”.
boolean
Disable the capability of a group from getting mentioned.
string ("disabled" | "private" | "enabled")
The wiki access level. Premium and Ultimate only.
boolean
Default to Auto DevOps pipeline for all projects within this group.
boolean
Prevent sharing a project with another group within this group.
string ("administrator" | "noone" | "maintainer" | "developer")
Determine if developers can create projects in the group.
boolean
Allow users to request member access.
string ("owner" | "maintainer")
Allowed to create subgroups.
integer
Time before Two-factor authentication is enforced (in hours).
string ("ssh" | "http" | "all")
Enabled protocols for Git access.
boolean
Enable experiment features for this group.
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.
boolean
Require all users in this group to set up two-factor authentication.
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}
integer
Can be set by administrators only. Additional compute minutes for this group. GitLab Self-Managed, Premium and Ultimate only.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_GROUP_VARIABLECreate a group-level CI/CD variable. Requires the Owner role for the group.

Input Parameters

string
required
ID or unencoded path of the group.
string
required
Variable key: at most 255 letters, digits, or underscores.
boolean
Whether the value is raw text; defaults to true. False expands variables in the value.
string
required
Value of the variable.
boolean
Whether the variable is masked.
boolean
Whether the variable is protected.
string
Variable description; defaults to null.
string ("env_var" | "file")
Variable type; defaults to env_var.
string
Environment scope. Requires Premium or Ultimate.
boolean
Whether the variable is masked and hidden; defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_GROUP_WIKI_PAGECreate a group wiki page with a title and content in a supported markup format. Requires a GitLab Premium or Ultimate group. See https://docs.gitlab.com/api/group_wikis/#create-a-wiki-page.

Input Parameters

string
required
ID or unencoded namespace path of the group.
string
required
Title of the wiki page.
string ("markdown" | "rdoc" | "asciidoc" | "org")
Wiki page format. GitLab defaults to markdown when omitted.
string
required
Content of the wiki page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_ISSUE_DISCUSSIONCreate an issue discussion thread that can receive replies. Backdating with created_at requires administrator or project/group owner rights.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
string
required
Content of the new discussion thread.
integer
required
Project-local IID of the issue.
string
ISO 8601 creation timestamp; requires administrator or project/group owner rights.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_ISSUE_NOTECreates a new note (comment) on a project issue in GitLab. Use this action when you need to add a comment, provide feedback, or document information on an existing issue.

Input Parameters

string
required
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.
string
required
The content of a note. Limited to 1,000,000 characters.
boolean
Controls note visibility. When set to true, the note is visible only to project members with at least Reporter role. Default is false.
integer
required
The internal ID of a project’s issue.
string
Date time string, ISO 8601 formatted, for example 2016-03-11T03:45:40Z. Requires administrator or project/group owner rights.
boolean
Deprecated flag for confidential notes; scheduled for removal in GitLab 16.0. Use ‘internal’ instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_LABELCreates a new label for a GitLab project with specified name, color, and optional attributes. Use this action when you need to create a new label for organizing issues and merge requests within a project. Labels help categorize and filter project items, making project management more efficient.

Input Parameters

string
required
The ID or URL-encoded path of the project (e.g., ‘12345’, ‘my-group/my-project’, or ‘my-group%2Fmy-project’).
string
required
The name of the label.
string
required
The color of the label given in 6-digit hex notation with leading ’#’ sign (e.g., #FFAABB) or CSS color names.
boolean
If true, marks the label as archived. Default value: false.
integer
The priority of the label. Must be greater than or equal to zero or null to remove priority.
string
The description of the label.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_MERGE_REQUESTCreates a new merge request in a GitLab project to propose changes from a source branch into a target branch. Use this action when you need to create a merge request for code review, feature integration, or bug fixes. This action requires both the source and target branches to exist in the project.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
required
The title of the merge request.
string
Comma-separated label names to assign to the merge request.
boolean
Squash commits into a single commit when merging.
integer
The ID of the user to assign the merge request to. Use assignee_ids for multiple assignees.
string
The description of the merge request. Supports Markdown formatting.
array
The IDs of users to assign the merge request to. Premium and Ultimate only.
integer
The global ID of a milestone to associate with the merge request.
array
The IDs of users to set as reviewers of the merge request. Premium and Ultimate only.
string
required
The source branch containing the changes to be merged.
string
required
The target branch into which the changes will be merged.
integer
The target project ID. Useful when creating merge requests across forks.
boolean
Allow commits from members who can merge to the target branch.
boolean
Automatically remove the source branch when the merge request is merged.
boolean
Deprecated. Use allow_collaboration instead. Allows commits from maintainers who can merge to the target branch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_MERGE_REQUEST_DEPENDENCYMake a merge request depend on another merge request being merged first. Specify a global blocking MR ID or its project-local IID. For a blocking IID in another project, also provide blocking_project_id.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
required
Internal ID of the merge request to be blocked.
string
ID or unencoded namespaced path of the blocking project. Defaults to the current project; required for a cross-project blocking IID.
string
Global numeric ID of the blocking merge request as a decimal string to preserve precision. Required unless blocking_merge_request_iid is provided.
integer
Project-local IID of the blocking merge request. Required unless blocking_merge_request_id is provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_MERGE_REQUEST_DISCUSSIONCreate a replyable merge request discussion on the overview or a diff position. For added lines supply new_line only; for removed lines supply old_line only; for unchanged lines supply both. Use line_range for multiline comments.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
string
required
Content of the new discussion thread.
object
Diff position; use the latest merge request version’s base/head/start SHAs. Omit for an overview thread.
string
Commit SHA to start this discussion on.
string
ISO 8601 creation timestamp; requires administrator or project/group owner rights.
integer
required
Project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_MERGE_REQUEST_DRAFT_NOTECreates and saves an unpublished merge request draft note that is visible only to its author. Use this action when the requested outcome is a saved draft for later publication; it does not publish a comment.

Input Parameters

string
required
Content of the unpublished draft note. Whitespace-only notes are rejected.
string
Commit SHA to associate with the draft note.
string
required
The numeric project ID or namespace/project path. URL encoding is handled automatically.
integer
required
The project-local IID of the merge request.
boolean
Whether publishing this draft should resolve its discussion.
string
Discussion ID to which this draft note replies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_MERGE_REQUEST_NOTECreate a merge request comment, not a line-specific diff discussion. Emoji-only content can create and return an emoji reaction instead of a note. Quick actions in the body can also change the merge request.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
string
required
Note content, up to 1,000,000 characters.
boolean
Whether the note is internal. GitLab defaults to false.
string
ISO 8601 creation timestamp; requires administrator or project/group owner rights.
integer
required
Project-local IID of the merge request.
string
Head commit SHA, required for the /merge quick action to guard against merge request updates.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_MERGE_REQUEST_PIPELINECreate a detached or, when enabled, merged results merge request pipeline. This does not run a regular branch/tag pipeline. Configure .gitlab-ci.yml for merge request jobs (for example, only: [merge_requests]).

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
required
Project-local internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_MILESTONECreates a new milestone in a GitLab project. Milestones track progress towards a goal with a start date, due date, and associated issues. Use this action when you need to establish a new project milestone for organizing work, tracking release schedules, or planning sprints.

Input Parameters

string
required
The ID or URL-encoded path of the project (e.g., ‘12345’ or ‘my-group/my-project’).
string
required
The title of the milestone.
string
The due date of the milestone in YYYY-MM-DD format.
string
The start date of the milestone in YYYY-MM-DD format.
string
The description of the milestone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_PERSONAL_SNIPPETCreate a personal snippet containing one or more files. Requires permission to create snippets. Prefer files over deprecated single-file fields. Limited to 300 requests per hour per user, shared with project snippet creation and the createSnippet GraphQL mutation. See https://docs.gitlab.com/api/snippets/#create-a-snippet.

Input Parameters

array
Snippet files with file_path and content; required unless using deprecated file_name and content together.
string
required
Title of the snippet.
string
Deprecated: use files instead. Snippet content; required with file_name when files is omitted.
string
Deprecated: use files instead. Snippet file name; required with content when files is omitted.
string ("public" | "private" | "internal")
Visibility level. The internal value is unavailable on GitLab.com.
string
Description of the snippet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_PIPELINETool to create a new pipeline for a specific branch or tag in a GitLab project. Use when you need to manually trigger a CI/CD pipeline run, optionally passing variables or inputs. For merge request pipelines, use the dedicated merge requests endpoint instead.

Input Parameters

string
required
The branch or tag name to create the pipeline for.
object
A hash of key-value pairs for CI/CD inputs when creating the pipeline. Available in GitLab 18.1 and later.
array
An array of pipeline variables. Each variable must have a ‘key’ and ‘value’. Optionally specify ‘variable_type’ as ‘env_var’ (default) or ‘file’.
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_PIPELINE_SCHEDULECreate a recurring pipeline schedule for a project’s branch or tag. Set active to false to create an initially deactivated schedule. Optional pipeline inputs require GitLab 17.11 or later (generally available in 18.1).

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
required
Branch or tag, as a short name or full ref (refs/heads/main or refs/tags/main). Use a full ref if a branch and tag share a name.
string
required
Cron schedule, for example 0 1 * * *.
boolean
Whether to activate the schedule. GitLab defaults to true.
array
Named pipeline inputs. Introduced in GitLab 17.11; generally available in 18.1.
string
required
Description of the pipeline schedule.
string
ActiveSupport::TimeZone time zone, such as Pacific Time (US & Canada). GitLab defaults to UTC.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_PIPELINE_SCHEDULE_VARIABLECreate a variable on an existing project pipeline schedule. Use env_var for an environment variable or file for a file-type variable.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
required
Variable key, at most 255 characters using only letters, digits, and underscores.
string
required
Value of the variable.
string ("env_var" | "file")
Variable type. GitLab defaults to env_var.
integer
required
ID of the pipeline schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_PROJECTTool to create a new project in GitLab. Implements POST /projects endpoint.

Input Parameters

string
required
The name of the project.
string
required
The path or URL-friendly name for the project.
string ("private" | "internal" | "public")
Project visibility.
string
Project description.
integer
The namespace (group or user ID) under which to create the project.
boolean
Enable wiki feature.
string
The default branch name.
boolean
Enable issues feature.
boolean
Enable snippets feature.
string
Git strategy for builds.
boolean
Enable merge requests feature.
boolean
Enable container registry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_PROJECT_ISSUETool 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.

Input Parameters

string
required
The global ID or URL-encoded path of the project (e.g., ‘12345’, ‘my-group/my-project’, or ‘my-group%2Fmy-project’).
integer
The internal ID of the project’s issue (requires administrator or project owner rights).
string
required
The title of an issue.
string
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.
integer
The weight of the issue. Valid values are greater than or equal to 0. Premium and Ultimate only.
integer
ID of the epic to add the issue to. Valid values are greater than or equal to 0. Premium and Ultimate only.
string
The due date. Date time string in the format YYYY-MM-DD, for example 2016-03-11.
integer
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.
string
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.
string ("issue" | "incident" | "test_case" | "task")
The type of issue. One of issue, incident, test_case or task. Default is issue.
integer
The ID of the user to assign the issue to. Only appears on GitLab Free.
string
The description of an issue. Limited to 1,048,576 characters.
array
The IDs of the users to assign the issue to. Premium and Ultimate only.
boolean
Set an issue to be confidential. Default is false.
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.
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.
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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_PROJECT_SNIPPETCreate a project snippet containing one or more files. Requires permission to create snippets and the files array. Deprecated single-file attributes are optional legacy fields. Creation is limited to 300 requests per hour per user, shared with personal snippet creation and the createSnippet GraphQL mutation. See https://docs.gitlab.com/api/project_snippets/#create-a-snippet.

Input Parameters

string
required
ID or unencoded namespace path of the project.
array
required
Required snippet files, each with file_path and content.
string
required
Title of the snippet.
string
Deprecated: use files instead. Legacy snippet content.
string
Deprecated: use files instead. Legacy snippet file name.
string ("public" | "private" | "internal")
Snippet visibility. The internal value is unavailable on GitLab.com.
string
Description of the snippet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_PROJECT_VARIABLECreate a project-level CI/CD variable. An existing key requires a different environment_scope; the same key and environment scope cannot be created twice.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
required
Variable key, at most 255 characters using only letters, digits, and underscores.
boolean
Whether the value is raw text. GitLab defaults to true; false expands variables in the value.
string
required
Value of the variable.
boolean
Whether the variable is masked. GitLab defaults to false.
boolean
Whether the variable is protected. GitLab defaults to false.
string
Description of the variable. GitLab defaults to null.
string ("env_var" | "file")
Variable type. GitLab defaults to env_var.
string
Environment scope of the variable. GitLab defaults to *.
boolean
Whether the variable is both masked and hidden. GitLab defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_PROJECT_WIKI_PAGECreate a project wiki page with a title and content in a supported markup format. See https://docs.gitlab.com/api/wikis/#create-a-wiki-page.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
required
Title of the wiki page.
string ("markdown" | "rdoc" | "asciidoc" | "org")
Wiki page format. GitLab defaults to markdown when omitted.
string
required
Content of the wiki page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_RELEASECreate a project release, optionally creating its tag and adding asset links. Requires at least Developer access. Supply ref when the tag does not exist. See https://docs.gitlab.com/api/releases/#create-a-release.

Input Parameters

string
required
ID or unencoded path of the project.
string
Commit SHA, tag, or branch; required if tag_name does not exist.
string
Release name.
object
Release asset links.
string
required
Git tag associated with the release.
array
Milestone titles. Group milestones require Premium and must belong to the project’s group, not ancestor groups.
string
Release description in Markdown.
string
ISO 8601 release timestamp, for example 2019-03-15T08:00:00Z. Omit for the current time; set for upcoming or historical releases.
string
Message to use when creating a new annotated tag.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_REPOSITORY_BRANCHTool 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.

Input Parameters

string
required
The branch name or commit SHA to create the new branch from.
string
required
The ID or URL-encoded path of the project.
string
required
The name of the new branch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_REPOSITORY_TAGCreate a repository tag pointing to a commit, branch, or existing tag. Supply a message for an annotated tag. Creation is subject to the project’s shared tag-creation rate limit and can return HTTP 429.

Input Parameters

string
required
ID or unencoded path of the project.
string
required
Commit SHA, tag name, or branch to tag.
string
Message to create an annotated tag; omit for a lightweight tag.
string
required
Name of the new tag.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_CREATE_WEBHOOKCreates a new webhook (project hook) for a GitLab project to receive real-time event notifications. Use this action when you need to set up automated integrations that respond to GitLab events like pushes, merge requests, issues, or CI/CD pipeline activities. Configure which events trigger the webhook by enabling the appropriate event flags. The webhook will send POST requests to your specified URL whenever the configured events occur.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
required
The URL to send webhook payloads to.
string
Name/identifier for the webhook.
string
Secret token for validating webhook payloads. GitLab includes this token in the X-Gitlab-Token header of webhook requests.
boolean
Trigger webhook on job/CI job events.
string
Description of the webhook’s purpose.
boolean
Trigger webhook on comment/note events.
boolean
Trigger webhook on push events.
boolean
Trigger webhook on emoji reaction events.
boolean
Trigger webhook on issue events.
string
HMAC signing token for webhook payload verification. Must be in format ‘whsec_<base64>’. GitLab uses this to sign payloads with HMAC.
boolean
Trigger webhook on pipeline events.
boolean
Trigger webhook on release events.
boolean
Trigger webhook on tag push events.
boolean
Trigger webhook on milestone events.
boolean
Trigger webhook on wiki page events.
boolean
Trigger webhook on deployment events.
boolean
Trigger webhook on feature flag events.
boolean
Trigger webhook on vulnerability events.
boolean
Trigger webhook on merge request events.
string
Strategy for filtering branches: ‘wildcard’ for glob patterns, ‘regex’ for regular expressions, ‘all_branches’ to trigger on all branches.
string
Custom payload format/template for webhook requests.
boolean
Enable SSL certificate verification when sending webhook requests. Set to false for self-signed certificates (not recommended for production).
boolean
Trigger webhook on confidential comment/note events.
string
Branch name or glob pattern to filter push events. Only pushes to matching branches trigger the webhook.
boolean
Trigger webhook on confidential issue events.
boolean
Trigger webhook on project access token expiry events.
boolean
Trigger webhook on deploy token expiry events.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_DEPLOYMENTDelete a deployment that is not running or the last deployment for its environment. The deployment must satisfy both prerequisites before deletion. GitLab rejects running deployments and deployments currently deployed to an environment. Returns an empty-response success indicator or GitLab’s confirmation message. See https://docs.gitlab.com/api/deployments/#delete-a-deployment.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the deployment to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_ENVIRONMENTDelete an environment from a project. The environment must be stopped first. Returns success for GitLab’s empty 204 response. GitLab returns 403 if the environment is not stopped and 404 if it does not exist. See https://docs.gitlab.com/api/environments/#delete-an-environment.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the stopped environment to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_GROUPDeletes a GitLab group by its ID or URL-encoded path. Use this action when you need to remove a group entirely. This action is irreversible — the group cannot be recovered once permanently removed. On GitLab.com, groups are retained for 30 days before permanent deletion unless permanently_remove=true is specified. You must have Owner permissions on the group to delete it.

Input Parameters

string
required
The ID or URL-encoded path of the group to be deleted.
string
The full path of the group (e.g., parent_group/subgroup). Required when permanently_remove=true.
boolean
If true, the group is deleted immediately. Otherwise, it is marked for deletion and removed after a retention period (30 days on GitLab.com, configurable on self-managed).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_GROUP_VARIABLEDelete a group-level CI/CD variable. Requires the Owner role for the group. When multiple variables share the key, use filter.environment_scope to select the variable to delete (Premium and Ultimate only). See https://docs.gitlab.com/api/group_level_variables/#delete-a-group-variable.

Input Parameters

string
required
Group ID or unencoded path of the group.
string
required
Key of the group CI/CD variable to delete.
object
Select the environment scope when keys repeat. Premium and Ultimate only.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_GROUP_WIKI_PAGEDelete a specified group wiki page. Requires a GitLab Premium or Ultimate group. See https://docs.gitlab.com/api/group_wikis/#delete-a-wiki-page.

Input Parameters

string
required
Group ID or unencoded group path.
string
required
Unique wiki page slug, without URL encoding, such as dir/page_name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_ISSUEDelete an issue from a project permanently. Planner or Owner roles can delete any issue; other project members can delete issues they authored (GitLab 18.10+).

Input Parameters

string
required
Project ID or unencoded project path, including namespaces.
integer
required
The internal ID of the project’s issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_ISSUE_DISCUSSION_NOTEPermanently delete an existing note from an issue discussion. See https://docs.gitlab.com/api/discussions/#delete-an-issue-thread-note.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the discussion note to delete.
integer
required
Project-local IID of the issue.
string
required
ID of the discussion containing the note.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_ISSUE_NOTEDeletes a note (comment) from an issue in a GitLab project. Use this action when you need to remove a specific comment from an issue. This action is irreversible — the note cannot be recovered once deleted.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The ID of the note to delete.
integer
required
The internal ID of the issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_JOB_ARTIFACTSPermanently delete a job’s archived files, metadata, and report artifacts. Artifacts cannot be recovered. The job log is not deleted. Requires the Maintainer or Owner role for the project. Returns success for HTTP 204. See https://docs.gitlab.com/api/job_artifacts/#delete-job-artifacts.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the job whose artifacts to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_LABELDeletes a label from a GitLab project by its ID or title. Use this action when you need to remove a label from a project permanently. This action is irreversible — the label cannot be recovered once deleted.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
required
The ID or title of the label to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_MERGE_REQUESTTool to permanently delete a merge request from a GitLab project. Use when you need to remove a merge request entirely, though closing is typically preferred to preserve the discussion history and audit trail. This action is irreversible — the merge request and its associated data cannot be recovered once deleted.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
Internal ID of the merge request to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_MERGE_REQUEST_DEPENDENCYDelete a merge request dependency without deleting either merge request. Requires permission to update the merge request and read the blocking merge request. See https://docs.gitlab.com/api/merge_requests/#delete-a-merge-request-dependency.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the dependency block to delete.
integer
required
Project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_MERGE_REQUEST_DISCUSSION_NOTEPermanently delete an existing note from a merge request discussion. See https://docs.gitlab.com/api/discussions/#delete-a-merge-request-thread-note.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the discussion note to delete.
string
required
ID of the discussion containing the note.
integer
required
Project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_MERGE_REQUEST_DRAFT_NOTEDeletes one caller-owned unpublished merge request draft note. This operation is irreversible and does not delete published comments.

Input Parameters

string
required
The numeric project ID or namespace/project path. URL encoding is handled automatically.
string
required
The ID of the unpublished draft note to delete.
integer
required
The project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_MERGE_REQUEST_NOTEDelete an existing note (comment) from a merge request. This permanently removes the specified note. See https://docs.gitlab.com/api/notes/#delete-a-merge-request-note.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the merge request note to delete.
integer
required
Project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_MILESTONEDeletes a project milestone by its ID. Use when you need to permanently remove a milestone from a project. This action is irreversible — the milestone cannot be recovered once deleted. Requires at minimum the Planner role for the project.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The ID of the milestone to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_PERSONAL_SNIPPETDelete an existing personal snippet. Returns success for GitLab’s 204 No Content response and raises an error if the snippet is not found (404).

Input Parameters

integer
required
ID of the personal snippet to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_PIPELINETool to delete a CI/CD pipeline by its ID within a specified project. This action expires all pipeline caches and deletes all immediately related objects such as builds, logs, artifacts, and triggers. This action is irreversible — the pipeline cannot be recovered once deleted. Use when you need to permanently remove a pipeline and all its associated data.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The ID of the pipeline to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_PIPELINE_SCHEDULEDelete a project’s pipeline schedule, preventing future scheduled runs. Returns the deleted schedule, or success for an empty response. See https://docs.gitlab.com/api/pipeline_schedules/#delete-a-pipeline-schedule.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the pipeline schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_PIPELINE_SCHEDULE_VARIABLEDelete a variable from a project’s pipeline schedule and return the deleted variable. See https://docs.gitlab.com/api/pipeline_schedules/#delete-a-variable-for-a-pipeline-schedule.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Key of the pipeline schedule variable to delete.
integer
required
ID of the pipeline schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_PROJECTTool 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.

Input Parameters

string
required
The ID or URL-encoded path of the project to be deleted.
string
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).
boolean
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).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_PROJECT_DEPLOY_KEYRemove a deploy key from a GitLab project. If no other project uses the key, GitLab deletes it from the system. See https://docs.gitlab.com/api/deploy_keys/#delete-deploy-key.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
ID of the deploy key to remove from the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_PROJECT_SNIPPETDelete a specified project snippet. Returns success for GitLab’s 204 No Content response and raises an error if the snippet is not found (404).

Input Parameters

string
required
Project ID or unencoded project path, including namespaces.
integer
required
ID of the project’s snippet to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_PROJECT_VARIABLEDelete a project’s CI/CD variable by key. When multiple variables share the key, use filter.environment_scope to select the variable to delete. See https://docs.gitlab.com/api/project_level_variables/#delete-a-variable.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Key of the project CI/CD variable to delete.
object
Filter by environment scope when multiple variables share a key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_PROJECT_WIKI_PAGEDelete a specified project wiki page. See https://docs.gitlab.com/api/wikis/#delete-a-wiki-page.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Unique wiki page slug, without URL encoding, such as dir/page_name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_RELEASEDelete a project release and return its release body, without deleting its tag. Requires at least the Developer role for the project. See https://docs.gitlab.com/api/releases/#delete-a-release.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Git tag associated with the release to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_REPOSITORY_BRANCHTool to delete a branch from a GitLab project repository. Use when you need to remove a branch that is no longer needed. This action is irreversible — the branch cannot be recovered once deleted. Cannot delete default or protected branches.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
required
The URL-encoded name of the branch to delete. Cannot be the default or a protected branch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_REPOSITORY_FILEDelete a file from a GitLab project’s repository by creating a commit on the specified branch. You can supply author details and a last known commit ID to detect concurrent modifications, or specify a starting branch when creating the target branch.

Input Parameters

string
required
Name of the branch where the file will be deleted.
string
required
URL-encoded full path to the file to delete (e.g., ‘lib/class.rb’ or ‘docs/readme.md’).
string
required
The ID or URL-encoded path of the project.
string
The commit author’s name. If not provided, uses the authenticated user’s name.
string
The commit author’s email address. If not provided, uses the authenticated user’s email.
string
Name of the base branch to create the new branch from. Used when the target branch doesn’t exist yet.
string
required
Commit message describing the file deletion.
string
Last known commit ID for the file. Used to detect concurrent modifications. If provided and the file has been modified since this commit, the deletion will fail.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_REPOSITORY_TAGDelete the specified repository tag from a project.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Name of the tag to delete, without URL encoding.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_REVIEW_APPSSchedule deletion of stopped environments in the review app folder. Defaults to a safe dry run. With dry_run=false, actual deletion takes place one week after execution. By default only environments 30 days or older are selected. Returns scheduled and unprocessable environment entries. See https://docs.gitlab.com/api/environments/#delete-multiple-stopped-review-apps.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Maximum environments to delete. Defaults to 100 on GitLab.
string
Delete environments older than this ISO 8601 datetime (YYYY-MM-DDTHH:MM:SSZ). Defaults to 30 days ago on GitLab.
boolean
Defaults to true on GitLab: preview without deleting. Set false to schedule actual deletion.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DELETE_WEBHOOKDeletes a project webhook/hook permanently from a GitLab project, removing the integration and stopping all event notifications. Use this action when you need to remove a webhook that is no longer needed or to clean up unused integrations. This action is irreversible — the webhook cannot be recovered once deleted.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The ID of the webhook to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DOWNLOAD_JOB_ARTIFACTSDownload a job’s artifacts archive or a specific report by job ID.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the job whose artifacts to download.
string ("accessibility" | "api_fuzzing" | "archive" | "browser_performance" | "cluster_image_scanning" | "cobertura" | "codequality" | "container_scanning" | "cyclonedx" | "dast" | "dependency_scanning" | "dotenv" | "jacoco" | "junit" | "license_scanning" | "load_performance" | "lsif" | "metrics" | "performance" | "requirements" | "requirements_v2" | "sarif" | "sast" | "secret_detection")
Artifact report type, introduced in GitLab 19.4. Defaults to archive (the full archive). Performance and browser_performance can return the other type if only that one was uploaded.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DOWNLOAD_JOB_ARTIFACTS_BY_REFDownload a named job’s artifacts archive from the latest successful pipeline for a branch or tag. Requires a completed successful pipeline with artifacts. Optionally search recent successful pipelines. Parent pipeline artifacts take precedence over child artifacts.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Name of the job whose artifacts archive to download.
string
required
Branch or tag name, not HEAD or a commit SHA. For merge request pipelines, use refs/merge-requests/:iid/head.
boolean
Search up to 100 recent successful pipelines instead of only the latest. Defaults to false on GitLab.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DOWNLOAD_PROJECT_AVATARTool to download a project’s avatar image. Use when you need the raw avatar bytes after confirming the project exists.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DOWNLOAD_PROJECT_UPLOADDownload a GitLab project Markdown upload by secret and filename.

Input Parameters

string
required
The name of the uploaded file to download.
string
required
The ID or URL-encoded path of the GitLab project.
string
required
The 32-character upload identifier from the GitLab project upload URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_DOWNLOAD_REPOSITORY_ARCHIVEDownload a repository archive, optionally limited to a ref and subpath. GitLab.com limits this endpoint to five requests per minute.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
Commit SHA, tag, or branch. Defaults to the default branch tip.
string
Repository subpath to download; empty means the whole repository.
string ("bz2" | "tar" | "tar.bz2" | "tar.gz" | "tb2" | "tbz" | "tbz2" | "zip")
Optional archive path extension. GitLab defaults to tar.gz.
string ("heads" | "tags")
Ref type for sha: heads for a branch or tags for a tag sharing its name.
string
Comma-separated paths to exclude from the archive.
boolean
Include LFS objects. GitLab defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_ENABLE_PROJECT_DEPLOY_KEYEnable an existing deploy key on a project and return the enabled key. See https://docs.gitlab.com/api/deploy_keys/#enable-a-deploy-key.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the existing deploy key to enable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_ERASE_JOBTool to erase the content of a specified job within a project. Use when you need to remove job artifacts and logs.

Input Parameters

integer
required
The ID of the job to be erased.
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_FORK_PROJECTForks a GitLab project to a specified namespace or the current user’s namespace. Creates an independent copy of the project that maintains a relationship with the source. Use this action when you need to create a personal or team copy of a project for development, experimentation, or contribution workflows.

Input Parameters

string
required
The ID or URL-encoded path of the project to fork.
string
The name for the forked project. If not specified, the name of the original project is used.
string
The path (URL-friendly name) for the forked project. If not specified, the path of the original project is used.
string
The ID or path of the namespace where the forked project will be created. If not specified, defaults to the current user’s namespace.
string ("private" | "internal" | "public")
The visibility level of the forked project. If not specified, the visibility of the original project is used.
string
The description for the forked project. If not specified, the description of the original project is used.
boolean
If true, merge requests in the forked project will target itself by default. If false, merge requests target the upstream (source) project. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GENERATE_RELEASE_EVIDENCECollect evidence for an existing release. Returns success, not a release object. See https://docs.gitlab.com/api/releases/#collect-release-evidence.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Git tag associated with the existing release.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_COMMIT_DIFFRetrieve a page of file diffs for a commit, branch, or tag in a project. Configured diff limits can stop pagination before all changed files are returned.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
string
required
Commit hash or repository branch or tag name.
integer
Page number, starting at 1.
boolean
Present diffs in unified diff format. GitLab defaults to false.
integer
Results per page (maximum 100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_COMMIT_REFSTool 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.

Input Parameters

string
required
The commit hash.
string ("branch" | "tag" | "all")
The scope of commits to list. Possible values are branch, tag, or all.
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_COMMIT_SEQUENCETool 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.

Input Parameters

string
required
The commit hash.
string
required
The ID or URL-encoded path of the project.
boolean
Follow only the first parent commit upon seeing a merge commit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_COMMIT_SIGNATURERetrieve a commit’s GPG, SSH, or X.509 signature. Unsigned commits return HTTP 404.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
string
required
Commit hash or repository branch or tag name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_CONTAINER_REGISTRY_TAGRetrieve metadata for one container image tag in a registry repository.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Container image tag name, supplied without URL encoding.
string
required
Container registry repository ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_CURRENT_USERRetrieves information about the currently authenticated user. Use this action when you need to get details about the user who owns the authentication token, such as their profile information, permissions, and settings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_DEPLOYMENTRetrieve one project deployment, including its job and available approval summary. See https://docs.gitlab.com/api/deployments/#retrieve-a-deployment.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the deployment to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_ENVIRONMENTRetrieve a project environment, including its last deployment and cluster agent. See https://docs.gitlab.com/api/environments/#retrieve-an-environment.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the environment to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_FILERetrieves a single file from a GitLab repository at a specific ref (branch, tag, or commit). Returns the file content as base64-encoded data along with metadata like size, encoding, and commit information. Use this action when you need to fetch the contents or details of a specific file from a GitLab project repository.

Input Parameters

string
required
Name of branch, tag, or commit. Use ‘HEAD’ to automatically use the default branch.
string
required
URL-encoded full path to the file in the repository.
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_FILE_BLAMEReturn commit attribution and lines for a GitLab repository file.

Input Parameters

string
required
Branch, tag, or commit SHA containing the file.
string
required
Full path to the file in the repository. URL-encoding is handled automatically.
integer
Last 1-based line to include. Must be provided with range_start and be greater than or equal to it.
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
integer
First 1-based line to include. Must be provided with range_end.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_GROUPTool to retrieve information about a specific group by its ID. Use when you need to get details of a GitLab group.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_GROUP_MEMBERTool 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.

Input Parameters

string
required
The ID or URL-encoded path of the group.
integer
required
The user ID of the group member to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_GROUP_MEMBER_ALLRetrieve one group member, including inherited and invited memberships. Use when the group and user IDs are known and direct membership alone is not sufficient. Visibility of invited private-group members depends on caller access.

Input Parameters

string
required
The numeric ID or unencoded namespace path of the group.
integer
required
The user ID of the member to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_GROUPSGet Groups

Input Parameters

integer
Page number for pagination.
string ("asc" | "desc")
Return groups sorted in ‘asc’ or ‘desc’ order.
boolean
Limit to groups owned by the current user.
Search for groups by name or path.
string ("id" | "name" | "path" | "similarity")
Return groups ordered by this field. Use ‘similarity’ when searching to order by relevance score.
integer
Number of results per page.
boolean
Include group statistics (admin only).
array
List of group IDs to exclude.
boolean
Include all groups the user has access to (admin only).
boolean
Include project details in response (deprecated).
boolean
Include groups requiring two-factor authentication.
integer
Limit to groups with minimum access level.
boolean
Include custom attributes in response (admins only).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_GROUP_VARIABLERetrieve a group CI/CD variable by key. Requires the group’s Owner role. Use filter to select an environment scope when variables share a key. See https://docs.gitlab.com/api/group_level_variables/#retrieve-details-of-a-group-variable.

Input Parameters

string
required
Group ID or unencoded group path.
string
required
Key of the group CI/CD variable.
object
Filter by environment scope. Premium and Ultimate only.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_GROUP_WIKI_PAGERetrieve a group wiki page, optionally as HTML or at a version SHA. Requires a GitLab Premium or Ultimate group. See https://docs.gitlab.com/api/group_wikis/#retrieve-a-wiki-page.

Input Parameters

string
required
Group ID or unencoded group path.
string
required
Unencoded wiki page slug, such as dir/page_name.
string
Wiki page version SHA.
boolean
Return the rendered HTML of the wiki page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_INSTANCE_VERSIONRetrieve the connected GitLab instance’s version, revision, edition, license plan, and Kubernetes agent server metadata. See https://docs.gitlab.com/api/metadata/.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_ISSUERetrieves a single issue from a GitLab project by its internal ID (iid). Returns comprehensive issue details including description, state, labels, assignees, time tracking, and task status. Use this action when you need to inspect a specific issue’s current state, check its metadata, or retrieve detailed information before performing updates or analysis. Requires knowing both the project ID/path and the issue’s internal ID.

Input Parameters

string
required
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.
integer
required
The internal ID of the project’s issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_ISSUE_BY_IDRetrieve an issue by its global ID. Administrator access is required. This does not accept a project-local IID. For a project ID/path and issue IID, use Get Issue instead. Returns issue details and preserves tier-specific fields.

Input Parameters

integer
required
Global issue ID, not the project-local issue IID. Requires administrator access.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_ISSUE_DISCUSSIONRetrieve one issue discussion and its notes without modifying it. See https://docs.gitlab.com/api/discussions/#retrieve-an-issue-discussion-item.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
Project-local issue IID.
string
required
ID of the discussion to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_ISSUE_NOTERetrieves a single comment (note) from a GitLab issue by its ID. Use this action when you need to fetch the details of a specific note on an issue, including its content, author information, and metadata.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The ID of the specific note to retrieve.
integer
required
Internal ID of the issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_JOB_DETAILSTool 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.

Input Parameters

integer
required
The ID of the job.
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_JOB_TRACERetrieves the trace (log output) for a specific CI/CD job within a project. Use this action when you need to view the execution logs of a job to debug failures, check output, or monitor job progress. The trace contains the complete console output from the job execution.

Input Parameters

integer
required
The ID of the job.
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_LABELRetrieves a single project label by its ID or title. Use this action when you need to fetch details about a specific label within a GitLab project, such as its color, description, or associated issue/MR counts.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
required
The label’s ID or title (name).
boolean
Include ancestor groups. Defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_MERGE_REQUEST_APPROVALSRetrieves aggregate approval status for a GitLab merge request on any GitLab tier. Returns every approving user, even when an approval does not satisfy a specific approval rule. Use Get Merge Request Approval State instead when Premium or Ultimate rule-level satisfaction is needed.

Input Parameters

string
required
The ID or URL-encoded path of the GitLab project.
integer
required
The project-scoped internal ID (IID) of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_MERGE_REQUEST_APPROVAL_STATERetrieves rule-level approval satisfaction for a GitLab merge request. This endpoint requires GitLab Premium or Ultimate and shows which users count toward each rule, not every user who approved. Use Get Merge Request Approvals for all-tier aggregate status and the complete approving-user list.

Input Parameters

string
required
The ID or URL-encoded path of the GitLab project.
integer
required
The project-scoped internal ID (IID) of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_MERGE_REQUEST_DIFF_VERSIONRetrieve a specific merge request diff version with its commits and file diffs. GitLab diff limits may exclude file contents. See https://docs.gitlab.com/api/merge_requests/#retrieve-a-merge-request-diff-version.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
boolean
Present diffs in unified diff format. Defaults to false.
integer
required
Merge request diff version ID.
integer
required
Project-local merge request IID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_MERGE_REQUEST_DISCUSSIONRetrieve one merge request discussion and its notes without modifying it. See https://docs.gitlab.com/api/discussions/#retrieve-a-merge-request-discussion-item.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
ID of the discussion to retrieve.
integer
required
Project-local merge request IID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_MERGE_REQUEST_DRAFT_NOTERetrieve an unpublished merge request draft note, visible only to its author. Does not publish or change the note. See https://docs.gitlab.com/api/draft_notes/#retrieve-a-draft-note.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the draft note to retrieve.
integer
required
Project-local merge request IID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_MERGE_REQUEST_NOTERetrieve one existing merge request note by its ID without modifying it. See https://docs.gitlab.com/api/notes/#retrieve-a-merge-request-note.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the merge request note to retrieve.
integer
required
Project-local merge request IID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_MERGE_REQUEST_NOTESFetches one page of comments on a specific merge request.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
Page number to retrieve.
integer
Number of notes per page (max 100).
integer
required
Internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_MERGE_REQUEST_RAW_DIFFSGet raw diffs of files changed in a merge request. GitLab diff limits may truncate results.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
Internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_MILESTONERetrieves a single milestone by its ID for a specific project. Returns detailed information including title, description, dates, and state. Use when you need to fetch complete details about a specific milestone.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The ID of the milestone within the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PERSONAL_SNIPPETRetrieve a personal snippet’s metadata, not its raw file content. See https://docs.gitlab.com/api/snippets/#retrieve-a-snippet.

Input Parameters

integer
required
ID of the snippet to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PIPELINE_SCHEDULERetrieve a project’s pipeline schedule, including its last pipeline and owner. Variables and inputs are only returned to Maintainers, Owners, or the schedule owner. See https://docs.gitlab.com/api/pipeline_schedules/#retrieve-a-pipeline-schedule.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the pipeline schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PIPELINE_SCHEDULE_VARIABLERetrieve a variable by key from a project’s pipeline schedule. See https://docs.gitlab.com/api/pipeline_schedules/#retrieve-a-variable-for-a-pipeline-schedule.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Key of the pipeline schedule variable.
integer
required
ID of the pipeline schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECTTool to get a single project by ID or URL-encoded path.

Input Parameters

string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_APPROVALSReturn project-wide merge request approval settings.

Input Parameters

string
required
The numeric project ID or namespace/project path. URL-encoding is handled automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_IMPORT_STATUSRetrieve the latest repository import state and failures for a project.

Input Parameters

string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_LANGUAGESTool to list programming languages used in a project with percentages. Use when you need the project language breakdown.

Input Parameters

string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_MEMBERTool to retrieve details for a specific project member. Use after confirming project and user IDs to fetch membership information for a project member.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The user ID of the project member to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_MEMBER_ALLTool 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).

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The user ID of the project member.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_MERGE_REQUESTTool 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.

Input Parameters

string
required
The ID or URL-encoded path of the project.
boolean
If true, response includes rendered HTML for title and description.
integer
required
Internal ID of the merge request.
boolean
If true, response includes whether a rebase operation is in progress.
boolean
If true, response includes the commits behind the target branch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_MERGE_REQUEST_COMMITSTool to get commits of a merge request. Use when you need to retrieve all commits associated with a specific merge request.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
Internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_MERGE_REQUESTSLists merge requests for a GitLab project, with filters including state, labels and milestones. Returns one page per request.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string ("yes" | "no")
Filter merge requests against their wip status.
array
Returns the request having the given iid.
integer
The page of results to return. Defaults to 1.
string ("asc" | "desc")
Returns requests sorted in the specified order. Default is desc.
string
If simple, returns the iid, URL, title, description, and basic state of merge request.
string ("created_by_me" | "assigned_to_me" | "all")
Returns merge requests for the given scope. Defaults to created_by_me.
string ("opened" | "closed" | "locked" | "merged")
Returns merge requests filtered by state.
string
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.
string
Search merge requests against their title and description.
string ("yes" | "no")
Filters merge requests by their approved status. Requires the mr_approved_filter feature flag, disabled by default.
string ("created_at" | "title" | "merged_at" | "updated_at")
Returns requests ordered by the specified field. Default is created_at.
integer
The number of results per page. Defaults to 20.
integer
Returns merge requests created by the given user id. Mutually exclusive with author_username. Combine with scope=all or scope=assigned_to_me.
string
Returns merge requests for a specific milestone. None returns merge requests with no milestone. Any returns merge requests that have an assigned milestone.
object
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.
integer
Returns merge requests assigned to the given user id. None returns unassigned merge requests. Any returns merge requests with an assignee.
string
Returns merge requests deployed to the given environment.
integer
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.
array
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.
string
Returns merge requests created on or after the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
integer
Returns the merge requests merged by the user with the given user id. Mutually exclusive with merge_user_username. Introduced in GitLab 17.0.
string
Returns merge requests with the given source branch.
string
Returns merge requests with the given target branch.
string
Returns merge requests updated on or after the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
string
Returns merge requests created on or before the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
string
Returns merge requests deployed after the given date/time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
string
Returns merge requests updated on or before the given time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
array
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.
string
Returns merge requests created by the given username. Mutually exclusive with author_id.
string
Returns merge requests deployed before the given date/time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
string
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.
string
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.
string
Returns the merge requests merged by the user with the given username. Mutually exclusive with merge_user_id. Introduced in GitLab 17.0.
boolean
If true, response returns more details for each label in labels field: :name, :color, :description, :description_html, :text_color. Default is false.
boolean
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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_RELEASERetrieve the complete release resource associated with a project tag.

Input Parameters

string
required
The Git tag associated with the release.
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
boolean
Whether to include the rendered HTML release description.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECTSLists projects accessible to the authenticated user, with filtering and pagination. Private or group projects may be omitted if access is insufficient; each request returns one page.

Input Parameters

integer
Page number for pagination. Iterate incrementally until an empty result is returned to retrieve a complete project inventory.
string ("asc" | "desc")
Return projects sorted in ‘asc’ or ‘desc’ order. Default is ‘desc’.
boolean
Limit by projects explicitly owned by the current user.
string
Return list of projects matching search criteria (case-insensitive substring).
boolean
Return only limited fields for each project.
boolean
Limit by projects starred by the current user.
boolean
Limit by archived status.
integer
Limit results to projects with IDs greater than the specified ID.
string ("id" | "name" | "path" | "created_at" | "updated_at" | "star_count" | "last_activity_at")
Return projects ordered by this field. Default is ‘created_at’.
integer
Number of items per page (1-100).
integer
Limit results to projects with IDs less than the specified ID.
boolean
Limit by projects that the current user is a member of.
boolean
Include project statistics. Available to Reporter role and above.
string ("private" | "internal" | "public")
Limit by project visibility.
integer
Limit by current user minimal role (access_level).
boolean
Limit by enabled issues feature.
boolean
Include custom attributes in response (admin only).
string
Limit by projects which use the given programming language.
boolean
Limit by enabled merge requests feature.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECTS_ID_MERGE_REQUESTS_IID_DIFFSLists diff version metadata for a GitLab merge request, including commit SHAs, state and creation time.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_SNIPPETRetrieve metadata for a specified project snippet, not its raw file content. See https://docs.gitlab.com/api/project_snippets/#retrieve-a-snippet.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the project’s snippet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_SNIPPET_DISCUSSIONRetrieve one discussion thread from a project snippet. For issue or merge request threads, use GITLAB_GET_ISSUE_DISCUSSION or GITLAB_GET_MERGE_REQUEST_DISCUSSION instead.

Input Parameters

string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
integer
required
The ID of the project snippet that owns the discussion.
string
required
The opaque GitLab discussion ID. URL-encoding is handled automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_VARIABLERetrieve a project’s CI/CD variable by key, optionally selecting its environment scope. See https://docs.gitlab.com/api/project_level_variables/#retrieve-a-single-variable.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Key of the project CI/CD variable.
object
Filter by environment scope when multiple variables share a key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_PROJECT_WIKI_PAGERetrieve a project wiki page, optionally as HTML or at a version SHA. See https://docs.gitlab.com/api/wikis/#retrieve-a-wiki-page.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Unencoded wiki page slug, such as dir/page_name.
string
Wiki page version SHA.
boolean
Return the rendered HTML of the wiki page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_RAW_FILERetrieves a file from a GitLab repository’s raw file endpoint as text, without Base64 encoding. The response includes the content type when available.

Input Parameters

boolean
When true, returns Git LFS file contents instead of the pointer file. Ignored for non-LFS tracked files.
string
The name of branch, tag, or commit to retrieve the file from. Defaults to HEAD (the project’s default branch).
string
required
The full path to the file in the repository (e.g., ‘app/models/key.rb’).
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_RAW_PERSONAL_SNIPPETGet a personal snippet’s raw contents as text.

Input Parameters

integer
required
ID of the personal snippet to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_RAW_PROJECT_SNIPPETRetrieve a project snippet’s raw content as plain text.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the project’s snippet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_RAW_REPOSITORY_BLOBRetrieves raw Git blob bytes by object SHA as a lossless Base64 string.

Input Parameters

string
required
The object SHA of the repository blob to retrieve.
string
required
The ID or URL-encoded path of the GitLab project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_REPOSITORY_BLOBRetrieve Base64-encoded Git blob content and metadata by object SHA.

Input Parameters

string
required
The full object SHA of the repository blob.
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_REPOSITORY_BLOBS_BATCHRetrieve up to 20 files with Base64-encoded content in one request. Requires authentication and GitLab’s experimental feature flag (404 if disabled); not production-ready. Each blob is truncated to its first 1 MB, with size reporting its full size. Missing files are omitted. The default rate limit is 5 requests per minute per user and project.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
array
required
File objects to retrieve (maximum 20).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_REPOSITORY_BRANCHTool to retrieve information about a specific branch in a project. Use when you need to get details for a single branch.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
required
The URL-encoded name of the branch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_REPOSITORY_BRANCHESRetrieves 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.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_REPOSITORY_FILE_METADATAReturn GitLab repository file metadata without downloading file content.

Input Parameters

string
required
Branch, tag, commit SHA, or HEAD containing the file.
string
required
Repository-relative path to the file. URL-encoding is handled automatically.
string
required
The numeric project ID or namespace/project path. URL-encoding is handled automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_REPOSITORY_TAGRetrieve one repository tag by name, including its commit and associated release.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Tag name, supplied without URL encoding.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_RUNNER_DETAILSRetrieve status and configuration details for a GitLab runner.

Input Parameters

integer
required
The numeric ID of the runner.
boolean
Whether to include assigned projects. GitLab defaults to true; set false to improve performance for runners with many projects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_SINGLE_COMMITTool 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.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
required
The commit hash or name of a repository branch or tag.
boolean
Include commit stats. Default is true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_SINGLE_PIPELINETool 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.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The ID of the pipeline.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_TAG_SIGNATURERetrieve a repository tag’s X.509 signature. Unsigned tags return HTTP 404.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Tag name, supplied without URL encoding.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_TIME_STATSRetrieves time tracking statistics for a specific issue in a project. Returns both machine-readable values (in seconds) and human-readable formatted durations. Use this action when you need to check time estimates, logged time, or track progress on an issue’s time budget.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The internal ID of the project’s issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_USERTool to retrieve information about a specific user by their ID. Use when you need to fetch details for a single GitLab user.

Input Parameters

integer
required
The ID of the user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_USER_PREFERENCESTool 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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_USERSTool 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.

Input Parameters

integer
Page number for pagination.
string ("asc" | "desc")
Return users sorted in ‘asc’ or ‘desc’ order. Default is ‘desc’. (Admin only)
boolean
Filters only active users. Default is false.
boolean
Return only administrators. Default is false. (Admin only)
boolean
Filters only regular users that are not bot or internal users. Default is false.
string
Search for users by name, username, or public email.
boolean
Filters only blocked users. Default is false.
boolean
Return only auditor users. Default is false. If not included, it returns all users. (Admin only, Premium and Ultimate only)
boolean
Filters only external users. Default is false.
string ("id" | "name" | "username" | "created_at" | "updated_at")
Return users ordered by ‘id’, ‘name’, ‘username’, ‘created_at’, or ‘updated_at’ fields. Default is ‘id’. (Admin only)
integer
Number of items per page for pagination.
string
The external provider. (Admin only)
string
Get a single user with a specific username.
boolean
Skip LDAP users. (Admin only, Premium and Ultimate only)
string
Get a single user with a specific external authentication provider UID. (Admin only)
string ("enabled" | "disabled")
Filter users by Two-factor authentication. Filter values are ‘enabled’ or ‘disabled’. (Admin only)
string
Return users created after specified time (ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ).
string
Return users created before specified time (ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ).
boolean
Filters only non active users. Default is false.
boolean
Filters only bot or internal users. Default is false.
boolean
Filters only non external users. Default is false.
boolean
Filters only non internal users. Default is false.
boolean
Filter users without projects. Default is false. (Admin only)
boolean
Filters user without project bots. Default is false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_USERS_ID_STATUSTool 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.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_USER_STATUSTool to get the current user’s status. Use when displaying or verifying the authenticated user’s GitLab status after login.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_USER_SUPPORT_PINTool 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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_GET_WEBHOOKRetrieves detailed information about a specific project webhook by its ID. Use this action when you need to inspect a webhook’s configuration, including its URL, enabled event triggers, SSL verification settings, and authentication details. This is useful for verifying webhook configurations or before updating webhook settings.

Input Parameters

integer
required
The ID of the webhook/hook to retrieve.
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_IMPORT_PROJECT_MEMBERSTool to import members from one project to another. Use when migrating members between projects.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_KEEP_JOB_ARTIFACTSPrevent a job’s artifacts from being automatically deleted at expiration. Returns the job details. See https://docs.gitlab.com/api/job_artifacts/#keep-job-artifacts.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the job whose artifacts to keep.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LINT_PROJECT_CI_CONFIGURATIONValidate the CI/CD configuration stored in a GitLab project.

Input Parameters

string
Deprecated branch or tag context for dry-run validation. Use dry_run_ref instead.
string
Deprecated commit SHA, branch, or tag containing the CI/CD configuration. Use content_ref instead.
boolean
Whether to simulate pipeline creation.
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
string
Commit SHA, branch, or tag containing the CI/CD configuration.
string
Branch or tag context for dry-run validation.
boolean
Whether to include resolved jobs in the result.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_ALL_GROUP_MEMBERSLists a page of group members, including direct, inherited, and invited members. Supports pagination to retrieve further members.

Input Parameters

string
required
The ID or URL-encoded path of the group.
integer
Page number for pagination.
integer
Number of items per page for pagination.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_ALL_PROJECT_MEMBERSLists a page of project members, including direct, inherited, and invited members. Supports filtering and pagination to retrieve further members.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
Page number for pagination.
string
Filters results based on a given name, email, or username. Use partial values to widen the scope of the query.
string ("awaiting" | "active")
Filter results by member state, one of ‘awaiting’ or ‘active’. Premium and Ultimate only.
integer
Number of items per page for pagination.
array
Filter the results on the given user IDs.
boolean
Show seat information for users.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_BILLABLE_GROUP_MEMBERSTool 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.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_BLOCKED_MERGE_REQUESTSList one page of merge requests blocked by the specified merge request. Returns dependency relationships with blocking and blocked merge request details. Follow next_page to retrieve additional results.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
integer
required
Project-local internal ID of the blocking merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_COMMIT_COMMENTSRetrieves all comments associated with a specific commit in a GitLab project. Use this action when you need to view discussions or feedback left on a particular commit, including both general comments and inline code review comments.

Input Parameters

string
required
The commit hash or name of a repository branch or tag.
string
required
The ID or URL-encoded path of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_COMMIT_MERGE_REQUESTSList one page of merge requests associated with a commit. Returns the merge request that originally introduced the commit. Optionally filter by state and follow next_page for more results.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Commit SHA.
integer
Page number, starting at 1.
string ("opened" | "closed" | "locked" | "merged")
Filter by merge request state; omit to include all states.
integer
Results per page (maximum 100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_COMMIT_STATUSESList one page of commit statuses, optionally filtered and sorted. By default GitLab returns only the latest statuses. Set all to true to include all statuses and follow next_page to retrieve additional pages.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
boolean
Include all statuses instead of latest only; default false.
string
Branch or tag name; defaults to the default branch.
string
required
Hash of the commit.
string
Filter statuses by job name.
integer
Page number, starting at 1.
string ("asc" | "desc")
Sort direction; default asc.
string
Filter statuses by build stage.
string ("id" | "pipeline_id")
Field to sort statuses by; default id.
integer
Results per page (maximum 100).
integer
Filter statuses by pipeline ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_DEPLOYMENT_MERGE_REQUESTSList one page of merge requests shipped with a deployment. Not all deployments can be associated with merge requests. Supports the Merge Requests API filters; follow next_page to retrieve subsequent pages. https://docs.gitlab.com/api/deployments/#list-all-merge-requests-associated-with-a-deployment

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
Search in title, description, or their comma-separated combination; defaults to both.
object
Exclude merge requests matching these filters.
string ("yes" | "no")
Deprecated in GitLab 19.0; use draft. Mutually exclusive with draft.
array
Return merge requests with these project-local IIDs.
integer
Page number, starting at 1.
string ("asc" | "desc")
Sort direction; default desc.
string
Return only basic merge request fields when simple.
boolean
Filter draft status; mutually exclusive with wip.
string ("created_by_me" | "assigned_to_me" | "reviews_for_me" | "all")
Scope; defaults to created_by_me.
string ("all" | "opened" | "closed" | "locked" | "merged")
Merge request state; default all.
string
Comma-separated labels, None for no labels, or Any for at least one label.
string
Search title and description; combine with in.
string ("created_at" | "updated_at" | "merged_at" | "label_priority" | "priority" | "milestone_due" | "popularity" | "title")
Sort field; default created_at.
integer
Results per page (maximum 100).
integer
Author ID; mutually exclusive with author_username. Combine with scope=all or assigned_to_me.
string
Milestone title, None for no milestone, or Any for an assigned milestone.
string
Assignee ID, None for unassigned, or Any for assigned; mutually exclusive with assignee_username.
string
Deployment environment name.
string
Reviewer ID, None for no reviewers, or Any for any reviewer; mutually exclusive with reviewer_username.
string
Eligible approver IDs, None for no eligible approvers, or Any for at least one. Premium/Ultimate only.
string
Inclusive ISO 8601 merge lower bound.
boolean
Only non-archived projects when true; default false.
string
Inclusive ISO 8601 creation lower bound.
integer
required
Deployment ID.
integer
Merging user ID; mutually exclusive with merge_user_username.
string
Inclusive ISO 8601 merge upper bound.
string
Source branch name.
string
Target branch name.
string
Inclusive ISO 8601 update lower bound.
string
Inclusive ISO 8601 creation upper bound.
string
ISO 8601 deployment lower bound.
string
Inclusive ISO 8601 update upper bound.
string
Approved by all these user IDs (up to 5), None for no approvals, or Any for an approval.
string
Author username; mutually exclusive with author_id.
string
ISO 8601 deployment upper bound.
array
Assignee usernames; mutually exclusive with assignee_id.
string
Current user’s reaction emoji, None for no reaction, or Any for a reaction.
string
Reviewer username, None, or Any; mutually exclusive with reviewer_id.
string
Merging username; mutually exclusive with merge_user_id.
boolean
Include label details rather than names; default false.
string
Approved by all these usernames (up to 5), None for no approvals, or Any for an approval.
boolean
Request asynchronous merge-status recalculation; not guaranteed and may require Developer or higher.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_ENVIRONMENTSList one page of project environments, filtered by exact name, search, or state.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
Exact environment name. Mutually exclusive with search.
integer
Page number, starting at 1.
string
Environment search string, at least 3 characters. Exclusive with name.
string ("available" | "stopping" | "stopped")
Filter by environment state. Omit to include all states.
integer
Results per page (maximum 100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_GROUP_ISSUESList one page of group issues with filters. Follow next_page to retrieve more results.

Input Parameters

string
required
Group ID or unencoded group path, including subgroups.
object
Exclude issues matching these documented group filters.
array
Issue internal IDs to return.
integer
Page number, starting at 1.
string ("asc" | "desc")
Sort direction; defaults to desc.
string ("created_by_me" | "assigned_to_me" | "all")
Issue scope; defaults to all.
string ("all" | "opened" | "closed")
Issue state to return.
string
Require all comma-separated labels. None means no labels; Any means at least one. No+Label is deprecated.
string
Search issue title and description.
string
Weight, None for no weight, or Any for an assigned weight. Premium/Ultimate only.
string
Epic ID, None for no epic, or Any for an epic. Premium/Ultimate only.
string ("0" | "any" | "today" | "tomorrow" | "overdue" | "week" | "month" | "next_month_and_previous_two_weeks")
Due-date filter; 0 means no due date.
string ("created_at" | "updated_at" | "priority" | "due_date" | "relative_position" | "label_priority" | "milestone_due" | "popularity" | "weight")
Sort field; defaults to created_at.
integer
Results per page (maximum 100).
integer
Author ID; mutually exclusive with author_username. Combine with scope=all or assigned_to_me.
string
Milestone title, None for no milestone, or Any for an assigned milestone.
string ("issue" | "incident" | "test_case" | "task")
Issue type to return.
string
Assignee user ID, None for unassigned, or Any for assigned. Mutually exclusive with assignee_username.
boolean
Filter confidential or public issues.
string
Iteration ID, None or Any. Mutually exclusive with iteration_title. Premium/Ultimate only.
boolean
Restrict to non-archived projects; defaults to true.
string
Inclusive creation lower bound in ISO 8601 format.
string
Inclusive update lower bound in ISO 8601 format.
string
Inclusive creation upper bound in ISO 8601 format.
string
Inclusive update upper bound in ISO 8601 format.
string
Author username; mutually exclusive with author_id.
string
Iteration title; mutually exclusive with iteration_id. Premium/Ultimate only.
array
Require all these assignees; CE supports one username. Mutually exclusive with assignee_id.
string
Authenticated user’s reaction emoji, None for no reaction, or Any for at least one.
boolean
Include label name, color, description, description_html, and text_color; defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_GROUP_MEMBERSTool to list direct members of a group. Use when you need to retrieve or filter a group’s direct membership.

Input Parameters

string
required
The ID or URL-encoded path of the group.
integer
Page number for pagination.
string ("access_level_asc" | "access_level_desc")
Order results by access level, ascending or descending.
string
Filter members by name, username, or email substring.
boolean
When true, return only active users.
integer
Number of results per page (1–100).
array
Membership relation types to include: direct, descendants, inherited, or shared.
array
List of user IDs to exclude from the results.
string ("enabled" | "disabled")
Filter users by two-factor authentication status.
boolean
Include members inherited from ancestor groups when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_GROUP_MERGE_REQUESTSList merge requests across a GitLab group and its subgroups.

Input Parameters

integer
Page number for offset pagination (1-based).
string ("created_by_me" | "assigned_to_me" | "reviews_for_me" | "all")
Limit results by relationship to the authenticated user. This group operation defaults to all.
string ("opened" | "closed" | "locked" | "merged" | "all")
Merge request state to return.
string
required
The numeric ID or full path of the group. URL-encoding is handled automatically.
integer
Number of merge requests per page (1-100).
string
Return merge requests updated on or after this ISO 8601 timestamp.
string
Return merge requests updated on or before this ISO 8601 timestamp.
string
Exclude merge requests created by this GitLab username.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_GROUP_PROJECTSTool to list projects within a GitLab group by group ID or full path. Use when discovering projects under a namespace or subgroup.

Input Parameters

string
required
The ID or URL-encoded path of the group.
integer
Page number for pagination.
string ("asc" | "desc")
Return projects sorted in ascending or descending order. Default is ‘desc’.
boolean
Limit by projects owned by the current user.
string
Return list of projects matching the search criteria.
boolean
Return only limited fields for each project.
boolean
Limit by projects starred by the current user.
boolean
Limit by archived status.
string ("id" | "name" | "path" | "created_at" | "updated_at" | "similarity" | "star_count" | "last_activity_at")
Return projects ordered by this field. Default is ‘created_at’.
integer
Number of items per page (1-100).
string ("private" | "internal" | "public")
Limit by visibility level.
boolean
Include projects shared to this group. Default is true.
integer
Limit to projects where current user has at least this access level.
boolean
Include projects in subgroups of this group. Default is false.
boolean
Limit by projects with issues feature enabled. Default is false.
boolean
Return only projects with security reports artifacts. Default is false.
boolean
Include custom attributes in response (administrators only).
boolean
Limit by projects with merge requests feature enabled. Default is false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_GROUP_RELEASESList one page of releases for projects in a group. Use simple for limited release fields and sort for ascending or descending order. Follow next_page for additional pages. The group endpoint has no order_by parameter. Current GitLab documentation lists Free, Premium, and Ultimate availability, with no Premium-only limitation stated.

Input Parameters

string
required
Group ID or unencoded namespace/group path.
integer
Page number, starting at 1.
string ("asc" | "desc")
Sort direction; defaults to descending (desc).
boolean
Return only limited fields for each release; defaults to false.
integer
Results per page (maximum 100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_GROUP_VARIABLESList one page of a group’s CI/CD variables, including available values. Requires the Owner role for the group. Use page and per_page to paginate; next_page indicates whether more results exist.

Input Parameters

string
required
Group ID or unencoded group path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_GROUP_WIKI_PAGESList one page of a group’s wiki pages, optionally including content. Requires a GitLab Premium or Ultimate group. Use page and per_page to paginate, following next_page for further results.

Input Parameters

string
required
Group ID or unencoded namespace/group path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
boolean
Include wiki pages’ content in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_ISSUE_CLOSING_MERGE_REQUESTSList one page of merge requests that close an issue when merged. Private projects and confidential issues require authorized credentials.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
integer
required
Internal ID of the issue within the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_ISSUE_DISCUSSIONSList one page of an issue’s discussions, including threaded and individual notes.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
integer
required
The project-local IID of the issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_ISSUE_NOTESRetrieves all notes (comments and activity) for a specific project issue in GitLab. Use this action when you need to view the discussion history, comments, or activity log on an issue to understand the context or follow up on conversations. Results are paginated and can be filtered by activity type or sorted by creation/update time.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
Page number to retrieve. Default is 1.
string ("asc" | "desc")
Return issue notes sorted in ascending or descending order. Default is descending.
string ("created_at" | "updated_at")
Return issue notes ordered by created_at or updated_at fields. Default is created_at.
integer
Number of notes per page. Default is 25, maximum is 100.
integer
required
The internal ID of the project issue.
string ("all_notes" | "only_comments" | "only_activity")
Filter notes by activity type. Default is all_notes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_ISSUE_PARTICIPANTSList one page of users participating in an issue. Follow next_page for more results. Private projects and confidential issues require credentials with access to the issue.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
integer
required
Internal ID of the issue in the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_ISSUESList one page of issues accessible to the authenticated user across projects. Defaults to issues created by the current user, not every accessible issue. Use filters to narrow results and next_page to continue pagination. GitLab.com may reject scope=all; use a group or project issues action in that case.

Input Parameters

string ("title" | "description" | "title,description" | "description,title")
Search fields; default title,description.
object
Exclusions supported by GET /issues, not project-specific filters.
array
Return only these issue internal IDs.
integer
Page number, starting at 1.
string ("asc" | "desc")
Sort direction; provider default desc.
string ("created_by_me" | "assigned_to_me" | "all")
Provider default created_by_me. GitLab.com may reject all with HTTP 400 when global listing is restricted; use group/project listing instead.
string ("all" | "opened" | "closed")
Issue state filter.
string
Comma-separated labels (all required), None for unlabeled, or Any for labeled. No+Label is deprecated.
string
Search issue titles and descriptions, narrowed by in.
string
Weight, None for unset, or Any for set (Premium/Ultimate).
string
Epic ID, None for no epic, or Any for an epic (Premium/Ultimate).
string ("0" | "any" | "today" | "tomorrow" | "overdue" | "week" | "month" | "next_month_and_previous_two_weeks")
Due-date window; 0 means no due date.
string ("created_at" | "due_date" | "label_priority" | "milestone_due" | "popularity" | "priority" | "relative_position" | "title" | "updated_at" | "weight")
Ordering field; provider default created_at.
integer
Results per page (maximum 100).
integer
Author ID; mutually exclusive with author_username. Combine with scope=all or assigned_to_me.
string
Milestone title; mutually exclusive with milestone_id. None/Any are planned for deprecation; use milestone_id.
string ("issue" | "incident" | "test_case" | "task")
Filter by issue type.
string
Assignee ID, None for unassigned, or Any for assigned; mutually exclusive with assignee_username.
boolean
Filter confidential (true) or public (false) issues.
string
Iteration ID, None, or Any; mutually exclusive with iteration_title (Premium/Ultimate).
string
Milestone timebox: None, Any, Upcoming, or Started; mutually exclusive with milestone.
boolean
Only non-archived projects (provider default true); false includes archived projects.
string
Created on or after this ISO 8601 timestamp.
string
Health status, None for unset, or Any for set (Ultimate).
string
Updated on or after this ISO 8601 timestamp.
string
Created on or before this ISO 8601 timestamp.
string
Updated on or before this ISO 8601 timestamp.
string
Author username; mutually exclusive with author_id.
string
Iteration title; mutually exclusive with iteration_id (Premium/Ultimate).
array
Issues assigned to all these usernames; CE accepts one. Mutually exclusive with assignee_id.
string
Reaction emoji, None for no reaction, or Any for any reaction by the current user.
boolean
Return label objects instead of names; provider default false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_JOB_ARTIFACT_FILESBrowse one page of a job’s artifact archive without downloading it. Optionally browse a subdirectory or list recursively. Nested directories are represented by entry paths, not nested children. Requires artifact metadata; GitLab returns 404 if the job, artifacts, metadata, or requested path is missing. CI/CD job token authentication is not exposed by this action.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Page number, starting at 1.
string
Path inside the artifacts archive; omit for the root directory.
integer
required
ID of the job whose artifacts to browse.
integer
Results per page (maximum 100).
boolean
Return entries recursively when true. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_JOB_TOKEN_ALLOWLISTList projects allowed to authenticate to a project with CI/CD job tokens.

Input Parameters

integer
Page number for offset pagination (1-based).
integer
Number of authorized projects to return per page (1-100).
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_LABELSLists a page of labels for a GitLab project, with optional filtering by name, archived status, and ancestor inclusion.

Input Parameters

string
required
The ID or URL-encoded path of the project. Can be a numeric ID (e.g., 123) or namespace path in format ‘namespace/project-name’ (e.g., ‘my-group/my-project’).
integer
Page number for pagination. Defaults to 1.
string
Keyword to filter labels by name.
boolean
If true, returns only archived labels. If unset, returns all labels.
integer
Number of labels per page. Defaults to 20.
boolean
Whether or not to include issue and merge request counts. Defaults to false.
boolean
Include labels from ancestor groups. Defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_MERGE_REQUEST_CLOSED_ISSUESList one page of issues that would close when a merge request is merged. These are not necessarily already closed. External trackers may return only an issue key and title. Follow next_page for additional results.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
integer
required
Project-local merge request IID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_MERGE_REQUEST_DEPENDENCIESList dependencies that must be resolved before a merge request can merge. Follow next_page for additional results. Blocking merge request details are omitted by GitLab when the caller lacks access to that merge request.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
integer
required
Project-local internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_MERGE_REQUEST_DIFFSList the files changed by a GitLab merge request, including available patch content. Results are paginated, with up to 100 changed files per page; unified diff format can be requested. GitLab may omit diff content because of its diff limits.

Input Parameters

integer
Page number to return. Defaults to 1.
boolean
If true, return each change in unified diff format.
integer
Number of changed files per page, from 1 to 100. Defaults to 20.
string
required
The numeric ID or namespace path of the project.
integer
required
The internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_MERGE_REQUEST_DISCUSSIONSLists grouped discussion threads and their notes for a merge request.

Input Parameters

integer
Page number to retrieve.
integer
Number of discussions to return per page, from 1 to 100.
string
required
The numeric project ID or namespace/project path. URL encoding is handled automatically.
integer
required
The project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_MERGE_REQUEST_DRAFT_NOTESLists the connected author’s unpublished draft notes for a merge request.

Input Parameters

integer
Page number to retrieve.
integer
Number of draft notes to return per page, from 1 to 100.
string
required
The numeric project ID or namespace/project path. URL encoding is handled automatically.
integer
required
The project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_MERGE_REQUEST_PARTICIPANTSList one page of participants for a merge request. Follow next_page to retrieve additional results.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
integer
required
Project-local internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_MERGE_REQUEST_PIPELINESList one page of pipelines for a merge request. Follow next_page to retrieve additional results.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
integer
required
Project-local internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_MERGE_REQUEST_REVIEWERSList a page of merge request reviewers with their review states. Follow next_page to retrieve additional results.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
integer
required
Project-local internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_MERGE_REQUESTSRetrieves a list of merge requests from across all accessible projects based on scope and filters. Use this action when you need to query merge requests at the instance or user level (not scoped to a specific project), such as finding all merge requests created by a user, assigned to a user, or awaiting review. By default returns merge requests created by the authenticated user; use scope=all to retrieve all accessible merge requests.

Input Parameters

string ("title" | "description" | "title,description")
Modify the scope of the search attribute. Options: title, description, or title,description (both). If not specified, searches both by default.
string ("yes" | "no")
Filter merge requests by work-in-progress status. Deprecated, use draft parameter instead.
integer
The page of results to return. Defaults to 1.
string ("asc" | "desc")
Returns requests sorted in the specified order. Default is desc.
string
If simple, returns the iid, URL, title, description, and basic state of merge request.
boolean
Filter merge requests by draft status. True returns draft merge requests, False returns non-draft merge requests.
string ("created_by_me" | "assigned_to_me" | "reviews_for_me" | "all")
Limit results by scope. Defaults to created_by_me. Use ‘all’ to see all merge requests across the instance (requires appropriate permissions).
string ("opened" | "closed" | "locked" | "merged" | "all")
Filter merge requests by state. Defaults to all if not specified.
string
Returns merge requests matching a comma-separated list of labels. Use None to list all merge requests with no labels or Any to list all merge requests with at least one label. Predefined names are case-insensitive.
string
Search merge requests against their title and description.
string ("created_at" | "updated_at" | "merged_at" | "label_priority" | "priority" | "milestone_due" | "popularity" | "title")
Returns requests ordered by the specified field. Default is created_at.
integer
The number of results per page. Defaults to 25.
integer
Returns merge requests created by the given user ID. Mutually exclusive with author_username.
string
Returns merge requests for a specific milestone. Use None for merge requests with no milestone or Any for merge requests that have an assigned milestone.
object
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.
string
Returns merge requests assigned to the given user ID. Use string ‘None’ for unassigned merge requests or ‘Any’ for merge requests with an assignee.
string
Returns merge requests deployed to the given environment.
string
Returns merge requests which have the user as a reviewer with the given user ID. Use string ‘None’ for merge requests with no reviewers or ‘Any’ for merge requests with any reviewer. Mutually exclusive with reviewer_username.
array
Returns merge requests which have all the users with the given IDs as individual approvers. Use None for merge requests without approvers or Any for merge requests with an approver. Premium and Ultimate only.
boolean
Return merge requests from non-archived projects only. Default is true.
string
Returns merge requests created on or after the given time. Expected in ISO 8601 format.
integer
Returns merge requests merged by the user with the given user ID. Mutually exclusive with merge_user_username. Introduced in GitLab 17.0.
string
Returns merge requests with the given source branch.
string
Returns merge requests with the given target branch.
string
Returns merge requests updated on or after the given time. Expected in ISO 8601 format.
string
Returns merge requests created on or before the given time. Expected in ISO 8601 format.
string
Returns merge requests deployed after the given date/time. Expected in ISO 8601 format.
string
Returns merge requests updated on or before the given time. Expected in ISO 8601 format.
array
Returns merge requests approved by all the users with the given IDs (up to 5 users). Use None for merge requests with no approvals or Any for merge requests with an approval. Premium and Ultimate only.
string
Returns merge requests created by the given username. Mutually exclusive with author_id.
string
Returns merge requests deployed before the given date/time. Expected in ISO 8601 format.
array
Returns merge requests assigned to the given username(s). Array parameter.
string
Returns merge requests reacted by the authenticated user by the given emoji. Use None for merge requests not given a reaction or Any for merge requests given at least one reaction.
string
Returns merge requests which have the user as a reviewer with the given username. Mutually exclusive with reviewer_id.
string
Returns merge requests merged by the user with the given username. Mutually exclusive with merge_user_id. Introduced in GitLab 17.0.
boolean
If true, response returns more details for each label in labels field: name, color, description, description_html, text_color. Default is false.
array
Returns merge requests approved by all the users with the given usernames (up to 5 users). Premium and Ultimate only.
boolean
If true, this projection requests (but does not guarantee) an asynchronous recalculation of the merge_status field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_MILESTONESLists a page of milestones for a specific project, with optional filtering by state, title, search terms, or IID.

Input Parameters

string
required
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.
array
Return milestones with specific internal IDs. Ignored if include_ancestors is true.
string ("active" | "closed")
Filter by milestone state: ‘active’ for open milestones or ‘closed’ for completed ones.
string
Return milestones matching the exact title.
string
Search milestones by title or description content.
string
Return milestones updated on or after this time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
string
Return milestones updated on or before this time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
boolean
Include milestones from parent groups. When true, iids parameter is ignored.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PACKAGE_FILESList the files belonging to a package in a GitLab project.

Input Parameters

integer
Page number for offset pagination (1-based).
string ("asc" | "desc")
Sort direction. GitLab defaults to ascending order.
string ("id" | "file_name" | "created_at")
Field used to order files. GitLab defaults to id.
integer
Number of package files to return per page (1-100).
integer
required
ID of the package whose files to list.
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PENDING_GROUP_MEMBERSTool 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.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PERSONAL_SNIPPETSList one page of the current user’s snippets, optionally filtered by creation time. Follow next_page with page and per_page to retrieve further results. See https://docs.gitlab.com/api/snippets/#list-all-snippets-for-current-user.

Input Parameters

integer
Page number, starting at 1.
integer
Results per page (maximum 100).
string
Return snippets created after this ISO 8601 timestamp.
string
Return snippets created before this ISO 8601 timestamp.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PIPELINE_JOBSTool 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.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
Page number for pagination (1-based).
string
The scope of jobs to show. Can be a single status or a list of statuses. If not provided, all jobs are returned.
integer
Number of items per page for pagination (max 100).
integer
required
The ID of the pipeline.
boolean
Include retried jobs in the response. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PIPELINE_SCHEDULE_PIPELINESList one page of pipelines triggered by a project’s pipeline schedule. Optionally filter by scope, status, or creation/update time and choose sort order. Follow next_page to retrieve additional results.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
Page number, starting at 1.
string ("asc" | "desc")
Sort order; GitLab defaults to asc.
string ("running" | "pending" | "finished" | "branches" | "tags")
Scope of pipelines to return.
string ("created" | "waiting_for_resource" | "preparing" | "waiting_for_callback" | "pending" | "running" | "success" | "failed" | "canceling" | "canceled" | "skipped" | "manual" | "scheduled")
Return pipelines with this status.
integer
Results per page (maximum 100).
string
Return pipelines created after this ISO 8601 datetime.
string
Return pipelines updated after this ISO 8601 datetime.
string
Return pipelines created before this ISO 8601 datetime.
string
Return pipelines updated before this ISO 8601 datetime.
integer
required
ID of the pipeline schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PIPELINE_SCHEDULESList one page of pipeline schedules for a project, optionally filtered by activity. Follow next_page for additional results. Inputs are visible only to Maintainers, Owners, or the schedule owner.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
Page number, starting at 1.
string ("active" | "inactive")
Return only active or inactive pipeline schedules.
integer
Results per page (maximum 100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PIPELINE_TRIGGER_JOBSList trigger jobs and downstream pipeline relationships for a pipeline.

Input Parameters

integer
Page number to return (1-based).
string
Return trigger jobs with one status or any status in the supplied list.
integer
Number of trigger jobs to return per page (1-100).
string
required
The numeric ID or namespace path of the project.
string
required
The numeric ID of the pipeline.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PIPELINE_VARIABLESRetrieve variables associated with a project pipeline. GitLab returns 404 if the pipeline variables file is missing from storage.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
required
ID of the pipeline.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_BOARDSReturn one page of issue boards configured for a GitLab project.

Input Parameters

integer
Page number for offset pagination (1-based).
integer
Number of issue boards per page (1-100).
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_DEPLOYMENTSList and filter deployments in a GitLab project.

Input Parameters

integer
Page number for offset pagination (1-based).
string ("asc" | "desc")
Sort direction. GitLab defaults to asc.
string ("created" | "running" | "success" | "failed" | "canceled" | "skipped" | "blocked")
Deployment status used to filter results.
string ("id" | "iid" | "created_at" | "updated_at" | "finished_at")
Field used to order deployments. GitLab defaults to id.
integer
Number of deployments per page (1-100).
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
string
Environment name used to filter deployments.
string
Return deployments updated after this ISO 8601 timestamp.
string
Return deployments finished after this ISO 8601 timestamp.
string
Return deployments updated before this ISO 8601 timestamp.
string
Return deployments finished before this ISO 8601 timestamp.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_GROUPSList a page of a GitLab project’s ancestor groups, with options to include shared groups and filter results.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
Page number of the results to retrieve.
string
Search for specific groups by name.
integer
Number of items to return per page.
array
Skip the group IDs passed.
boolean
Include projects shared with this group. Default is false.
boolean
Limit to shared groups user has access to.
integer
Limit to shared groups with at least this access level.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_INVITED_GROUPSTool to list groups invited to a project. Use when auditing which groups have access to a project.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
Page number for pagination.
integer
Number of items to return per page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_ISSUESTool 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.

Input Parameters

string
required
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.
array
Return specific issues by their internal IDs.
integer
The page of results to return. Defaults to 1.
string ("asc" | "desc")
Order direction. Default: desc.
string ("created_by_me" | "assigned_to_me" | "all")
Filter scope. Default: all.
string ("all" | "opened" | "closed")
Filter by issue state.
string
Comma-separated label names; issues must have all specified labels.
string
Search in title and description.
integer
Filter by weight value. Premium/Ultimate only.
integer
Issues associated with a specific epic ID. Premium/Ultimate only.
string ("0" | "any" | "today" | "tomorrow" | "overdue" | "week" | "month" | "next_month_and_previous_two_weeks")
Filter by due date status.
string ("created_at" | "updated_at" | "priority" | "due_date" | "relative_position" | "label_priority" | "milestone_due" | "popularity" | "weight")
Sort by the specified field. Default: created_at.
integer
The number of results per page. Defaults to 20.
integer
Return issues created by a specific user ID.
string
Filter by milestone title.
string ("issue" | "incident" | "test_case" | "task")
Filter by issue type.
string
Return issues assigned to a specific user ID. Use the string ‘None’ for unassigned issues or ‘Any’ for issues assigned to someone.
boolean
Filter confidential or public issues.
integer
Issues assigned to a specific iteration. Premium/Ultimate only.
string
Issues created on or after this time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
string
Issues updated on or after this time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
string
Issues created on or before this time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
string
Issues updated on or before this time. Expected in ISO 8601 format (2019-03-15T08:00:00Z).
string
Return issues created by a specific username.
string
Issues assigned to iteration with given title. Premium/Ultimate only.
array
Return issues assigned to given username(s).
string
Issues reacted to by authenticated user with specified emoji.
boolean
Return detailed label information (name, color, description, HTML description, text color). Default: false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_JOBSList one page of a project’s CI/CD jobs, newest first, optionally filtered by status.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Page number, starting at 1.
string
One job status or a list of statuses. Omit to return all statuses.
integer
Results per page (maximum 100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_MEMBERSList one page of direct project members viewable by the authenticated user. Does not include inherited members or memberships through invited groups. See https://docs.gitlab.com/api/project_members/#list-all-direct-members-of-a-project.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Page number, starting at 1.
string
Partial name, email, or username to filter members.
integer
Results per page (maximum 100).
array
Only return these user IDs.
array
Exclude these user IDs.
boolean
Include seat information for users.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_PACKAGESList and filter packages in a GitLab project’s package registry.

Input Parameters

integer
Page number for offset pagination (1-based).
string ("asc" | "desc")
Sort direction. GitLab defaults to asc.
string ("default" | "hidden" | "processing" | "error" | "pending_destruction" | "deprecated")
Package-status filter.
string ("created_at" | "name" | "version" | "type")
Field used to order packages. GitLab defaults to created_at.
integer
Number of packages per page (1-100).
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
string
Fuzzy package-name filter.
string ("cargo" | "composer" | "conan" | "debian" | "generic" | "golang" | "helm" | "maven" | "ml_model" | "npm" | "nuget" | "pypi" | "rpm" | "rubygems" | "terraform_module")
Package ecosystem to return.
string
Exact package-version filter.
boolean
Whether to include packages that have no version.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_PIPELINESTool 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.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
The ref of pipelines.
string
The SHA of pipelines.
string
Return pipelines with the specified name.
integer
Page number for pagination.
string ("asc" | "desc")
Sort pipelines in ‘asc’ or ‘desc’ order.
string ("running" | "pending" | "finished" | "branches" | "tags")
The scope of pipelines, one of: ‘running’, ‘pending’, ‘finished’, ‘branches’, ‘tags’.
string
The pipeline source. To return child pipelines, set to ‘parent_pipeline’.
string ("created" | "waiting_for_resource" | "preparing" | "pending" | "running" | "success" | "failed" | "canceled" | "skipped" | "manual" | "scheduled")
The status of pipelines.
string ("id" | "status" | "ref" | "updated_at" | "user_id")
Order pipelines by ‘id’, ‘status’, ‘ref’, ‘updated_at’ or ‘user_id’.
integer
Number of items per page for pagination.
string
The username of the user who triggered pipelines.
boolean
Returns pipelines with invalid configurations.
string
Return pipelines created after the specified date (ISO 8601 format).
string
Return pipelines updated after the specified date (ISO 8601 format).
string
Return pipelines created before the specified date (ISO 8601 format).
string
Return pipelines updated before the specified date (ISO 8601 format).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_REGISTRY_REPOSITORIESList one page of container registry repositories for a GitLab project.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Page number, starting at 1.
boolean
Include each repository’s tags when true.
integer
Results per page (maximum 100).
boolean
Include each repository’s tag count when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_RELEASESList one page of project releases, sorted by released_at descending by default. Optionally sort by creation time or include rendered descriptions. Follow next_page to retrieve additional releases.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Page number, starting at 1.
string ("asc" | "desc")
Sort direction; defaults to desc.
string ("released_at" | "created_at")
Field to order releases by; defaults to released_at.
integer
Results per page (maximum 100).
boolean
Include the release description rendered as HTML.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_RUNNERSList runners available to a GitLab project with filtering and pagination.

Input Parameters

integer
Page number to return.
string ("instance_type" | "group_type" | "project_type")
Return runners of this type.
string ("active" | "paused" | "online" | "offline")
Deprecated runner scope filter. Use type or status instead.
boolean
Whether to return only runners that are paused or accepting jobs.
string ("online" | "offline" | "stale" | "never_contacted")
Return runners with this status.
integer
Number of runners per page, from 1 to 100.
array
Return runners with all of these tags.
string
required
The ID or path of the project. URL-encoding is handled automatically.
string
Return runners whose version starts with this prefix.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_SHAREABLE_GROUPSTool to list groups that can be shared with a project. Use before sharing a project to fetch eligible groups.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
Page number for pagination.
string
Search term to filter groups by name or path.
integer
Number of items per page for pagination.
array
List of group IDs to exclude from the results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_SNIPPETSList one page of snippets for a project. Use page and per_page to paginate, following next_page for further results.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_TAGSLists repository tags for a GitLab project, with search and ordering options. Returns one page per request.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
Page number of the results to retrieve.
string ("asc" | "desc")
Return tags sorted in the specified order. Default is desc.
string
Return a list of tags matching the search criteria. You can use ^term and term$ to find tags that begin and end with term.
string ("name" | "updated" | "version")
Return tags ordered by the specified field. Default is updated.
integer
Number of items to return per page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_TRANSFER_LOCATIONSTool to list namespaces available for project transfer. Use when you need to determine which groups a project can be transferred into.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
Page number for pagination (1-based).
string
The group names to search for.
integer
Number of items per page for pagination.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_USERSTool to list users of a project. Use after you have a project ID and want to retrieve its users.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
Page number for pagination (1-based).
string
Filter users by name or username.
integer
Number of items per page for pagination (max 100).
array
List of user IDs to exclude from the result.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_VARIABLESList one page of a project’s CI/CD variables, including available values. Use page and per_page to paginate; next_page indicates whether more results exist.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROJECT_WIKI_PAGESList one page of a project’s wiki pages, optionally including content. Use page and per_page to paginate, following next_page for further results.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
Page number, starting at 1.
integer
Results per page (maximum 100).
boolean
Include wiki pages’ content in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_PROTECTED_TAGSList tag protection rules configured for a GitLab project.

Input Parameters

integer
Page number for offset pagination (1-based).
integer
Number of protected tag rules to return per page (1-100).
string
required
The numeric project ID or namespace/project path. URL-encoding is handled automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_REPOSITORY_COMMITSTool 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.

Input Parameters

boolean
Retrieve every commit from the repository. When set to true, the ref_name parameter is ignored.
integer
Page number for pagination (1-based).
string
The file path to filter commits by.
string ("default" | "topo")
List commits in order. Possible values: default, topo. Defaults to default, the commits are shown in reverse chronological order.
string
Only commits after or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ.
string
Only commits before or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ.
string
Search commits by commit author.
integer
Number of items per page for pagination (max 100).
string
The name of a repository branch, tag or revision range, or if not given the default branch.
boolean
Parse and include Git trailers for every commit.
string
required
The ID or URL-encoded path of the project.
boolean
Stats about each commit are added to the response.
boolean
Follow only the first parent commit upon seeing a merge commit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_REPOSITORY_TREELists files and directories in a GitLab project’s repository tree, optionally at a specified path and branch, tag, or commit. Supports recursive listing or including the latest commit for each entry, but not both together. Results are paginated using offset or keyset pagination.

Input Parameters

string
Branch, tag, or commit SHA to list. Defaults to the project’s default branch.
integer
Page number for offset pagination (1-based).
string
Repository directory path to list. Omit to list the repository root.
integer
Number of tree entries to return per page (1-100).
boolean
Whether to recursively include entries below the requested path.
string
Opaque token from next_page_token for the next keyset page.
string
Set to keyset to use GitLab keyset pagination.
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
boolean
Whether to include the most recent commit for each tree entry. Cannot be combined with recursive=true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_RUNNER_JOBSList one page of jobs processed by a GitLab runner.

Input Parameters

integer
required
Runner ID.
integer
Page number, starting at 1.
string ("asc" | "desc")
Sort direction. Requires order_by.
string ("canceled" | "canceling" | "created" | "failed" | "manual" | "pending" | "preparing" | "running" | "scheduled" | "skipped" | "success" | "waiting_for_callback" | "waiting_for_resource")
Return only jobs with this status.
string
Order jobs by ID.
integer
Results per page (maximum 100).
string
System ID of the runner manager machine.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_TODOSList the connected user’s GitLab to-do items with filters and pagination.

Input Parameters

integer
Page number for offset pagination (1-based).
string ("pending" | "done")
Return to-do items in this state. GitLab defaults to pending.
string ("assigned" | "mentioned" | "build_failed" | "marked" | "approval_required" | "unmergeable" | "directly_addressed" | "merge_train_removed" | "review_requested" | "member_access_requested" | "review_submitted" | "okr_checkin_requested" | "added_approver" | "ssh_key_expired" | "ssh_key_expiring_soon" | "duo_pro_access_granted" | "duo_enterprise_access_granted" | "duo_core_access_granted" | "duo_workflow_input_required" | "transfer_failed")
Return to-do items created by this action.
string
Return to-do items associated with this group ID, provided as a string to preserve precision.
integer
Number of to-do items to return per page (1-100).
string
Return to-do items created by this user ID, provided as a string to preserve precision.
string
Return to-do items associated with this project ID, provided as a string to preserve precision.
string ("Issue" | "MergeRequest" | "Commit" | "Epic" | "DesignManagement::Design" | "AlertManagement::Alert" | "Project" | "Namespace" | "Vulnerability" | "WikiPage::Meta" | "WorkItem" | "Key" | "User" | "ComplianceManagement::Projects::ComplianceViolation" | "Ai::DuoWorkflows::Workflow")
Return to-do items whose target has this GitLab resource type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_USER_EVENTSList contribution events for a GitLab user.

Input Parameters

integer
Page number for offset pagination (1-based).
string ("asc" | "desc")
Sort events by creation date in ascending or descending order. GitLab defaults to descending.
string
Return events created after this ISO 8601 date (YYYY-MM-DD).
string ("created" | "updated" | "closed" | "reopened" | "pushed" | "commented" | "merged" | "joined" | "left" | "destroyed" | "expired" | "approved" | "transferred")
Return only events with this action type.
string
Return events created before this ISO 8601 date (YYYY-MM-DD).
string
required
The numeric ID or username of the GitLab user. URL-encoding is handled automatically.
integer
Number of events to return per page (1-100).
string ("design" | "issue" | "merge_request" | "milestone" | "note" | "project" | "snippet" | "user" | "wiki")
Return only events for this target resource type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_USER_PROJECTSTool to list projects owned by a specific user. Use after obtaining target user identity to fetch owned projects.

Input Parameters

string
required
The ID or username of the user whose projects to list.
integer
Page number for pagination.
string ("asc" | "desc")
Return projects sorted in asc or desc order. Default is ‘desc’.
boolean
Limit by projects explicitly owned by the specified user.
string
Return list of projects matching search criteria (case-insensitive substring).
boolean
Return only limited fields for each project.
boolean
Limit by projects starred by the specified user.
boolean
Limit by archived status.
integer
Limit results to projects with IDs greater than the specified ID.
string ("id" | "name" | "path" | "created_at" | "updated_at" | "star_count" | "last_activity_at")
Return projects ordered by this field. Default is ‘created_at’.
integer
Number of items per page (1-100).
integer
Limit results to projects with IDs less than the specified ID.
boolean
Limit by projects that the current user is a member of.
boolean
Include project statistics. Available to Reporter role and above.
string ("private" | "internal" | "public")
Limit by project visibility.
string
Limit projects updated after given time (ISO 8601).
string
Limit projects updated before given time (ISO 8601).
integer
Limit by current user minimal role (access_level).
boolean
Limit by enabled issues feature.
boolean
Include custom attributes in response (admin only).
string
Limit by projects which use the given programming language.
boolean
Limit by enabled merge requests feature.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_LIST_WEBHOOKSLists a page of webhooks configured for a GitLab project, including URLs, event triggers, and SSL settings. Webhook secret tokens and URL variables are redacted from the response.

Input Parameters

integer
Page number for pagination. Defaults to 1.
integer
Number of results per page. Defaults to 20, maximum is 100.
string
required
The ID or URL-encoded path of the project. Use numeric ID (e.g., 123) or namespace path (e.g., ‘my-group/my-project’). URL-encoding is handled automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_MERGE_MERGE_REQUESTMerge a GitLab merge request immediately or enable auto-merge when checks pass. A successful merge is irreversible, and should_remove_source_branch can also delete the source branch.

Input Parameters

string
Expected HEAD SHA of the source branch. The merge fails if the current HEAD differs.
boolean
If true, squash all commits into one commit when merging.
boolean
If true, merge automatically when all required checks pass.
string
required
The numeric ID or namespace path of the project.
integer
required
The internal ID of the merge request to merge.
string
Custom message for the merge commit.
string
Custom message for the squash commit.
boolean
If true, remove the source branch after the merge.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_MOVE_ISSUEMoves an issue from one project to another in GitLab. The issue receives a new IID and project_id in the destination project. Use this action when you need to relocate an issue to a different project, such as when reorganizing work or transferring issues between team projects. If equivalent labels or milestones exist in the destination project, they are automatically assigned to the moved issue.

Input Parameters

string
required
The global ID or URL-encoded path of the source project (e.g., ‘12345’, ‘my-group/my-project’).
integer
required
The internal ID of the project’s issue to move.
integer
required
The ID of the destination project where the issue will be moved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_PLAY_JOBTriggers execution of a manual job in a GitLab project. Use this action when you need to start or run a job that requires manual intervention or has a manual status.

Input Parameters

integer
required
The ID of the job to play.
object
Custom job input values for the execution. This is a hash of key-value pairs.
string
required
The ID or URL-encoded path of the project.
array
Custom variables as key-value pairs to pass to the job.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_PLAY_PIPELINE_SCHEDULERun a project’s pipeline schedule immediately without affecting its next scheduled run. Returns GitLab’s confirmation message, not a pipeline object. See https://docs.gitlab.com/api/pipeline_schedules/#run-a-pipeline-schedule-immediately.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the pipeline schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_POST_USER_SUPPORT_PINTool to create a support PIN for your authenticated user. Use when GitLab Support requests a PIN to verify your identity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_PROTECT_BRANCHProtects a repository branch in a GitLab project by setting access controls for push, merge, and unprotect operations. Use this action when you need to enforce branch protection rules to prevent unauthorized modifications or deletions of important branches like main, master, or release branches. Protected branches can restrict who can push, merge, force push, and remove protection.

Input Parameters

string
required
The name of the branch or wildcard pattern to protect
string
required
The ID or URL-encoded path of the project
array
Array of access levels allowed to push, with each described by a hash of user_id, group_id, deploy_key_id, or access_level (Premium/Ultimate only)
boolean
When enabled, members who can push to this branch can also force push
array
Array of access levels allowed to merge, with each described by a hash of user_id, group_id, or access_level (Premium/Ultimate only)
integer
Default access level allowed to push. Valid values: 0 (No access), 30 (Developer), 40 (Maintainer, default), 60 (Admin)
integer
Default access level allowed to merge. Valid values: 0 (No access), 30 (Developer), 40 (Maintainer, default), 60 (Admin)
array
Array of access levels allowed to unprotect, with each described by a hash of user_id, group_id, or access_level (Premium/Ultimate only)
integer
Default access level allowed to unprotect. Valid values: 30 (Developer), 40 (Maintainer, default), 60 (Admin)
boolean
Prevent pushes to this branch if it matches an item in the CODEOWNERS file (Premium and Ultimate only)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_PUBLISH_ALL_MERGE_REQUEST_DRAFT_NOTESPublish all pending draft notes belonging to the authenticated user on a merge request. Optionally add a summary note and set the review state without recording a formal approval. GitLab may normalize note bodies when publishing. See https://docs.gitlab.com/api/draft_notes/#publish-all-pending-draft-notes.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
Text of a summary note to add to the merge request.
boolean
If true, the summary note is internal.
string ("requested_changes" | "reviewed")
Review state to set after publishing; does not record a formal approval.
integer
required
Project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_PUBLISH_MERGE_REQUEST_DRAFT_NOTEPublish one pending draft note as a comment on a merge request. Before publication, draft notes are visible only to their author. GitLab may normalize the note body when publishing. Returns success, not a note object. See https://docs.gitlab.com/api/draft_notes/#publish-a-draft-note.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the draft note to publish.
integer
required
Project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_PUT_USER_PREFERENCESUpdates the current user’s diff viewing and CI identity preferences. All three settings must be supplied together.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_REBASE_MERGE_REQUESTEnqueue rebasing a merge request’s source branch against its target branch. HTTP 202 means queued, not completed. Poll the retrieve merge request endpoint with include_rebase_in_progress=true to check rebase_in_progress and merge_error. Requires permission to push to the source branch, including force push when protected. See https://docs.gitlab.com/api/merge_requests/#rebase-a-merge-request.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
boolean
Set to true to skip creating a CI pipeline.
integer
required
Project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_REMOVE_GROUP_MEMBERRemove a user explicitly assigned a role in a group. This does not remove users who only belong directly to a project in the group. By default, direct memberships in subgroups and projects are also removed. See https://docs.gitlab.com/api/members/#remove-a-group-member.

Input Parameters

string
required
ID or unencoded namespace path of the group.
integer
required
User ID of the member to remove.
boolean
Skip deletion of direct memberships in subgroups and projects. GitLab defaults to false.
boolean
Unassign the member from issues and merge requests in the group or project. GitLab defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_REMOVE_PROJECT_MEMBERRemove a direct member of a project, not an inherited membership. Optionally skip subresource membership removal or unassign project issuables. See https://docs.gitlab.com/api/project_members/#remove-a-direct-member-of-a-project.

Input Parameters

string
required
ID or unencoded namespace path of the project.
integer
required
User ID of the direct member to remove.
boolean
Skip deleting the member’s direct memberships in subgroups and projects. GitLab defaults to false.
boolean
Unassign the removed member from issues and merge requests in the project. GitLab defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_REORDER_ISSUEReorder a project issue for manually sorted issue lists. Position references use global issue IDs, not project-local IIDs. Supply at least one reference. Each name identifies the neighbor that should be before or after the reordered issue, not a move-command direction.

Input Parameters

string
required
Global project ID or unencoded namespaced project path.
integer
required
Project-local IID of the issue to reorder.
integer
Global ID of a project’s issue that should be placed after this issue.
integer
Global ID of a project’s issue that should be placed before this issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_REPLY_ISSUE_DISCUSSIONAdd a note to an issue thread, or turn a single comment into a thread. System notes cannot receive replies (GitLab returns HTTP 400). See https://docs.gitlab.com/api/discussions/#add-a-note-to-an-issue-thread.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
string
required
Content of the note or reply.
integer
required
Project-local IID of the issue.
string
ISO 8601 creation timestamp; requires administrator or project/group owner rights.
string
required
ID of the discussion thread.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_REPLY_MERGE_REQUEST_DISCUSSIONAdd a note to a merge request thread, or turn a single comment into a thread. See https://docs.gitlab.com/api/discussions/#add-note-to-a-merge-request-thread.

Input Parameters

string
required
Project ID or unencoded namespaced project path.
string
required
Content of the note or reply.
string
ISO 8601 creation timestamp; requires administrator or project/group owner rights.
string
required
ID of the discussion thread.
integer
required
Project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_REPLY_SNIPPET_DISCUSSIONPost a reply in an existing project snippet discussion thread. For issue or merge request threads, use GITLAB_REPLY_ISSUE_DISCUSSION or GITLAB_REPLY_MERGE_REQUEST_DISCUSSION instead.

Input Parameters

string
required
The reply text.
string
ISO 8601 creation time for the reply, e.g. 2026-10-29T12:00:00Z. Setting a custom time requires administrator or project or group owner rights.
string
required
The numeric project ID or namespace/project path. URL encoding is handled automatically.
integer
required
The ID of the project snippet that owns the discussion.
string
required
The ID of the discussion thread to reply to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_RESET_MERGE_REQUEST_APPROVALSReset all approvals for a specified merge request. Available only to bot users with a valid project or group token. Human users receive 401 Unauthorized, even with an otherwise valid personal access token. See https://docs.gitlab.com/api/merge_request_approvals/#reset-approvals-for-a-merge-request.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
Project-local internal ID (IID) of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_RESET_SPENT_TIMEResets the total spent time for a specified GitLab issue to 0 seconds. This action is irreversible — all previously recorded time entries will be cleared and cannot be recovered. Use this action when you need to clear all time tracking entries for an issue and start time tracking from scratch.

Input Parameters

string
required
The global ID or URL-encoded path of the project (e.g., ‘12345’, ‘my-group/my-project’, or ‘my-group%2Fmy-project’).
integer
required
The internal ID of the project’s issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_RESET_TIME_ESTIMATEResets the estimated time for a specified issue to 0 seconds. Use this action when you need to clear a previously set time estimate on an issue while preserving the total time spent.

Input Parameters

string
required
The global ID or URL-encoded path of the project.
integer
required
The internal ID of the project’s issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_RESTORE_PROJECTRestore a project marked for deletion before it is permanently deleted.

Input Parameters

string
required
Project ID or unencoded namespaced path, such as group/project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_RETRY_JOBRetry a single CI/CD job, optionally supplying job input values. Returns the retried job. Trigger jobs require GitLab 17.0 or later. See https://docs.gitlab.com/api/jobs/#retry-a-job.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the job to retry.
object
Hash of job input names and values to use for the retry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_RETRY_PIPELINERetries failed or canceled jobs in a pipeline. Use this action when you need to re-run a pipeline that has failed or was canceled. Note that if there are no failed or canceled jobs in the pipeline, calling this action has no effect.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
The ID of the pipeline to retry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_REVERT_COMMITRevert a commit on a target branch, creating a new commit. Set dry_run=true to check applicability without writing. Conflicting or already-reverted changes can fail.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
SHA of the commit to revert.
string
required
Target branch name.
boolean
If true, check whether the revert applies without committing changes. GitLab defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_SEARCH_GLOBALLYSearch visible resources and repository content across a GitLab instance.

Input Parameters

integer
Page number for offset pagination (1-based).
string ("asc" | "desc")
Sort direction for ordered results.
array
Work-item types to include. Applies only to the work_items scope.
boolean
Whether exact code search uses regular expressions. Requires search_type=‘zoekt’; GitLab rejects it with other search types.
string ("projects" | "groups" | "issues" | "work_items" | "merge_requests" | "milestones" | "snippet_titles" | "users" | "wiki_blobs" | "commits" | "blobs" | "notes")
required
Instance resource type to search. Result fields vary by scope.
string
Filter by state for issues, work_items, and merge_requests scopes; other scopes ignore this filter.
array
Fields to search. Only title is supported, for issues and merge_requests scopes on Premium and Ultimate tiers.
string
required
Term to search for across the GitLab instance.
string ("created_at" | "title")
Field used to order results. Title ordering is limited by scope and search type.
integer
Number of search results to return per page (1-100).
array
Label names that every result must have. Accepts up to 30 names for issues, merge_requests, and work_items with advanced search. Premium and Ultimate only.
string ("basic" | "advanced" | "zoekt")
Search backend to use: basic, advanced, or exact code search (zoekt).
boolean
Filter by confidentiality for issues and work_items scopes; other scopes ignore this filter.
boolean
Whether exact code search excludes forked projects. Requires search_type=‘zoekt’; GitLab rejects it with other search types.
string
Filter by source branch. Applies only to merge_requests with advanced search on Premium and Ultimate tiers.
string
Filter by target branch. Applies only to merge_requests with advanced search on Premium and Ultimate tiers.
string
Filter by author username for issues, merge_requests, and work_items scopes with advanced search. Premium and Ultimate only.
boolean
Whether to include archived projects in global search results.
integer
Number of context lines around each match. Applies only to advanced and exact code search.
string
Exclude merge requests with this source branch. Applies only to merge_requests with advanced search on Premium and Ultimate tiers.
string
Exclude merge requests with this target branch. Applies only to merge_requests with advanced search on Premium and Ultimate tiers.
string
Exclude results by author username for issues, merge_requests, and work_items with advanced search. Premium and Ultimate only.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_SEARCH_GROUPSearch resources and repository content within one GitLab group.

Input Parameters

string
required
The numeric ID or path of the group. URL-encoding is handled automatically.
integer
Page number for offset pagination (1-based).
string ("asc" | "desc")
Sort direction for ordered results.
array
Work-item types to include. Applies only to the work_items scope.
boolean
Whether exact code search uses regular expressions. Requires search_type=‘zoekt’.
string ("projects" | "groups" | "issues" | "work_items" | "merge_requests" | "milestones" | "users" | "wiki_blobs" | "commits" | "blobs" | "notes")
required
Group resource type to search. Result fields vary by scope.
string
Filter by state for issues, work_items, and merge_requests scopes; other scopes ignore this filter.
array
Fields to search. Only title is supported, for issues and merge_requests scopes on Premium and Ultimate tiers.
string
required
Term to search for in the selected group scope.
string ("created_at" | "title")
Field used to order results. Title ordering is limited by scope and search type.
integer
Number of search results to return per page (1-100).
array
Label names that every result must have. Accepts up to 30 names for issues, merge_requests, and work_items with advanced search.
string ("basic" | "advanced" | "zoekt")
Search backend to use: basic, advanced, or exact code search (zoekt).
boolean
Filter by confidentiality for issues and work_items scopes; other scopes ignore this filter.
boolean
Whether exact code search excludes forked projects. Requires search_type=‘zoekt’.
string
Filter merge requests by source branch when using advanced search.
string
Filter merge requests by target branch when using advanced search.
string
Filter by author username for issues, merge_requests, and work_items with advanced search. Premium and Ultimate only.
boolean
Whether to include archived projects in group search results.
integer
Number of context lines around each match. Applies only to advanced and exact code search.
string
Exclude merge requests with this source branch when using advanced search.
string
Exclude merge requests with this target branch when using advanced search.
string
Exclude results by author username for issues, merge_requests, and work_items with advanced search.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_SEARCH_PROJECTSearch resources and repository content within one GitLab project.

Input Parameters

string
Repository branch or tag to search. Valid only for blobs, commits, and wiki_blobs scopes; defaults to the project’s default branch.
integer
Page number for offset pagination (1-based).
string ("asc" | "desc")
Sort direction for ordered results.
array
Work-item types to include. Applies only to the work_items scope.
boolean
Whether exact code search uses regular expressions. Applies only to exact code search.
string ("issues" | "work_items" | "merge_requests" | "milestones" | "users" | "wiki_blobs" | "commits" | "blobs" | "notes")
required
Project resource type to search. Result fields vary by scope.
string
Filter by state for issues, work_items, and merge_requests scopes; other scopes ignore this filter.
array
Fields to search. Only title is supported, for issues and merge_requests scopes on Premium and Ultimate tiers.
string
required
Term to search for in the selected project scope.
string ("created_at" | "title")
Field used to order results. Title ordering is limited by scope and search type.
integer
Number of search results to return per page (1-100).
array
Label names that every result must have. Accepts up to 30 names for issues, merge_requests, and work_items with advanced search. Premium and Ultimate only.
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
string ("basic" | "advanced" | "zoekt")
Search backend to use: basic, advanced, or exact code search (zoekt).
boolean
Filter by confidentiality for issues and work_items scopes; other scopes ignore this filter.
string
Filter by source branch. Applies only to merge_requests with advanced search on Premium and Ultimate tiers.
string
Filter by target branch. Applies only to merge_requests with advanced search on Premium and Ultimate tiers.
string
Filter by author username for issues, merge_requests, and work_items scopes with advanced search. Premium and Ultimate only.
integer
Number of context lines around each match. Applies only to advanced and exact code search.
string
Exclude merge requests with this source branch. Applies only to merge_requests with advanced search on Premium and Ultimate tiers.
string
Exclude merge requests with this target branch. Applies only to merge_requests with advanced search on Premium and Ultimate tiers.
string
Exclude results by author username for issues, merge_requests, and work_items with advanced search. Premium and Ultimate only.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_SET_PROJECT_APPROVALSUpdate project-level merge request approval behavior.

Input Parameters

string
required
The numeric project ID or namespace/project path. URL encoding is handled automatically.
boolean
Remove existing approvals when new commits are pushed.
boolean
Remove only approvals from Code Owners whose owned files change. Setting this to true requires reset_approvals_on_push to be explicitly false.
boolean
Allow merge request authors to approve their own merge requests.
boolean
Require users to reauthenticate before approving a merge request.
boolean
Prevent users who add commits from approving the merge request.
boolean
Prevent merge requests from overriding the project approval rules.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_SET_TIME_ESTIMATESets the estimated time to complete an issue in a GitLab project. Use this action when you need to set or update the time estimate for tracking project work. The estimate is specified in human-readable format like ‘3h30m’ for 3 hours and 30 minutes.

Input Parameters

string
required
The global ID or URL-encoded path of the project.
string
required
The time estimate in human-readable format (e.g., ‘3h30m’, ‘2h’, ‘45m’). Use ‘h’ for hours and ‘m’ for minutes.
integer
required
The internal ID of the project’s issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_SET_USER_STATUSSets the current GitLab user’s status message and emoji, with an optional automatic clearing interval.

Input Parameters

string
Name of the emoji to use as status. Defaults to ‘speech_balloon’ if omitted.
string
Status message to display. Max 100 characters; can contain emoji codes.
string ("30_minutes" | "3_hours" | "8_hours" | "1_day" | "3_days" | "7_days" | "30_days")
Automatically clear status after the specified time interval. Allowed values: 30_minutes, 3_hours, 8_hours, 1_day, 3_days, 7_days, 30_days.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_SHARE_PROJECT_WITH_GROUPTool to share a project with a group. Use when you need to grant a group specific access level to a project.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_STAR_PROJECTStars a project in GitLab, marking it as a favorite for the authenticated user. This adds the project to your starred projects list and increments its star count. Use this action when you want to bookmark or show support for a project. The operation is idempotent - starring an already-starred project succeeds without error.

Input Parameters

string
required
The ID or URL-encoded path of the project to star.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_START_PROJECT_HOUSEKEEPINGTool to start the housekeeping task for a project. Use when you need to trigger manual maintenance or pruning on a repository.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string ("prune" | "eager")
Type of housekeeping task to perform. prune triggers a manual prune of unreachable objects; eager triggers eager housekeeping.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_STOP_ENVIRONMENTStop a running environment, optionally skipping its on_stop actions. See https://docs.gitlab.com/api/environments/#stop-an-environment.

Input Parameters

string
required
ID or unencoded namespace path of the project.
boolean
Stop without executing on_stop actions when true.
integer
required
ID of the environment to stop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_STOP_STALE_ENVIRONMENTSRequest stopping all environments last modified or deployed to before a date. Protected environments are excluded. Confirmation means the stop was requested, not that all environments have finished stopping. See https://docs.gitlab.com/api/environments/#stop-stale-environments.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
required
Stop environments last modified or deployed to before this ISO 8601 timestamp (for example, 2019-03-15T08:00:00Z). Must be between 10 years ago and 1 week ago.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_TAKE_PIPELINE_SCHEDULE_OWNERSHIPTake ownership of a project’s pipeline schedule as the authenticated user. Returns the updated schedule and owner. See https://docs.gitlab.com/api/pipeline_schedules/#update-ownership-of-a-pipeline-schedule.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
integer
required
ID of the pipeline schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_TRANSFER_PROJECTMove a GitLab project to another namespace. GitLab may complete the namespace move asynchronously after accepting the transfer.

Input Parameters

string
required
The numeric ID or path of the destination namespace.
string
required
The numeric ID or namespace path of the project to transfer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UNAPPROVE_MERGE_REQUESTRemoves the approval from the currently authenticated user for a specified merge request. Use this action when you need to revoke your previously given approval on a merge request. The action requires the merge request to have been previously approved by the authenticated user.

Input Parameters

string
required
The ID or URL-encoded path of the project.
integer
required
Internal ID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UNARCHIVE_PROJECTUnarchive a GitLab project to restore active use. Requires administrator access or the Owner role on the project. Idempotent: unarchiving an already unarchived project does not change it.

Input Parameters

string
required
Project ID or unencoded namespace/project path to unarchive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UNPROTECT_BRANCHTool to remove protection from a branch in a GitLab project. Use this action when you need to unprotect a branch, allowing unrestricted push and merge access. This action is irreversible in the sense that protection rules must be manually reapplied if needed later.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
required
The name of the branch to unprotect, or a wildcard pattern.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UNSTAR_PROJECTUnstar a previously starred GitLab project to remove it from your favorites list. Use this action when you need to remove a project from your starred projects. This action removes the star that was previously added by the authenticated user.

Input Parameters

string
required
The ID or URL-encoded path of the project to unstar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_DEPLOYMENTUpdate the status of a project’s deployment. See https://docs.gitlab.com/api/deployments/#update-a-deployment.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string ("running" | "success" | "failed" | "canceled")
required
New status of the deployment.
integer
required
ID of the deployment to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_ENVIRONMENTUpdate an environment’s settings, without renaming it. See https://docs.gitlab.com/api/environments/#update-an-existing-environment. Omit a setting to leave it unchanged; explicit null removes supported associations.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string ("production" | "staging" | "testing" | "development" | "other")
Deployment tier of the environment.
string
Description of the environment.
string
New external environment URL.
integer
required
ID of the environment to update.
integer
Cluster agent ID to associate; explicit null removes it.
string ("always" | "with_action")
Auto-stop setting: always, with_action, or explicit null.
string
Flux resource path to associate; explicit null removes it.
string
Kubernetes namespace to associate; explicit null removes it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_GROUPUpdates an existing GitLab group’s settings and properties. Use this action when you need to modify group configuration such as name, path, visibility, permissions, or feature settings. Administrators can update additional settings like shared runners limits and IP restrictions.

Input Parameters

string
required
The ID or URL-encoded path of the group.
string
The name of the group.
string
The path of the group.
string
Image file for avatar of the group. Provide a URL to download the image.
string ("private" | "internal" | "public")
The group’s visibility level.
string
The group’s description.
boolean
Enable/disable Large File Storage (LFS) for the projects in this group.
string
The default branch name for group’s projects.
boolean
Enable email notifications.
boolean
Users cannot be added to projects in this group. Premium and Ultimate only.
string ("default_on" | "default_off" | "never_on")
Duo availability setting. Note: In the UI, never_on is displayed as “Always Off”.
boolean
Disable the capability of a group from getting mentioned.
string ("disabled" | "private" | "enabled")
The wiki access level. Premium and Ultimate only.
boolean
Default to Auto DevOps pipeline for all projects within this group.
string
Comma-separated IP addresses or subnet masks to restrict group access. Premium and Ultimate only.
boolean
Prevent sharing a project with another group within this group.
string ("noone" | "maintainer" | "developer")
Determine if developers can create projects in the group.
boolean
Allow users to request member access.
string ("owner" | "maintainer")
Allowed to create subgroups.
integer
Time before Two-factor authentication is enforced (in hours).
integer
The ID of the project for file templates. Premium and Ultimate only.
string ("ssh" | "http" | "all")
Enabled protocols for Git access.
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.
boolean
Prevent project forking outside current group. Premium and Ultimate only.
integer
Maximum number of unique projects a user can download in the specified time period before they are banned. Premium and Ultimate only.
boolean
Require all users in this group to set up two-factor authentication.
integer
Can be set by administrators only. Additional compute minutes for this group. GitLab Self-Managed, Premium and Ultimate only.
boolean
When enabled, users are automatically banned from the group when they download more than the maximum number of unique projects. Premium and Ultimate only.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_GROUP_MEMBERUpdate a group member’s access level, expiration, or custom role. Promotions may be queued for administrator approval rather than applied immediately. See https://docs.gitlab.com/api/members/#update-a-group-member.

Input Parameters

string
required
ID or unencoded namespace path of the group.
integer
required
User ID of the member to update.
string
Membership expiration date in YEAR-MONTH-DAY format.
integer ("5" | "10" | "15" | "20" | "25" | "30" | "40" | "50")
required
Access level: Guest (10), Planner (15), Reporter (20), Security Manager (25), Developer (30), Maintainer (40), or Owner (50). Minimal access (5) requires a top-level group on Premium or Ultimate.
integer
Ultimate only: custom member role ID. If no value is specified, removes all custom roles.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_GROUP_MEMBER_STATEChange a user’s group membership state to awaiting or active. The change applies to all subgroups and projects and can allow access when a user is over the free user limit. See https://docs.gitlab.com/api/members/#change-group-membership-state-for-a-user.

Input Parameters

string
required
ID or unencoded namespace path of the group.
string ("awaiting" | "active")
required
New membership state: awaiting or active.
integer
required
User ID of the member.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_GROUP_VARIABLEUpdate a group CI/CD variable. Requires the Owner role for the group. Use filter.environment_scope to select the existing scope and environment_scope to set the new scope. Verify the selected scope exists with the retrieve endpoint first: GitLab falls back to another scope with the same key if it does not exist. See https://docs.gitlab.com/api/group_level_variables/#update-a-group-variable.

Input Parameters

string
required
ID or unencoded path of the group.
string
required
Key of the group variable to update.
boolean
Whether the value is raw text; defaults to true. False expands variables in the value.
string
required
New value of the variable.
object
Select the existing scope when variables share a key. Premium or Ultimate only.
boolean
Whether the variable is masked.
boolean
Whether the variable is protected.
string
Description of the variable. GitLab defaults to null.
string ("env_var" | "file")
Variable type: env_var (GitLab default) or file.
string
New environment scope. Premium or Ultimate only.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_GROUP_WIKI_PAGEUpdate a group wiki page’s content, title, and optional markup format. Requires a GitLab Premium or Ultimate group. Provide content or title (or both). Changing the title can change the page slug. See https://docs.gitlab.com/api/group_wikis/#update-a-wiki-page.

Input Parameters

string
required
ID or unencoded namespace path of the group.
string
required
Unencoded unique wiki page slug, such as dir/page_name.
string
Wiki page title. Required when content is omitted.
string ("markdown" | "rdoc" | "asciidoc" | "org")
Wiki page format. GitLab documents markdown as the default.
string
Wiki page content. Required when title is omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_ISSUE_DISCUSSION_NOTEUpdate the content of an existing issue discussion note. See https://docs.gitlab.com/api/discussions/#update-an-issue-thread-note.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Updated content of the note or reply.
integer
required
ID of the thread note to update.
integer
required
Project-local IID of the issue.
string
required
ID of the discussion thread.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_ISSUE_NOTEUpdates an existing note (comment) on a GitLab issue. Use this action when you need to edit the content of a previously created comment on an issue. This is useful for correcting typos, adding additional information, or updating outdated information in issue discussions.

Input Parameters

string
required
The global ID or URL-encoded path of the project.
string
The content of the note. Limited to 1,000,000 characters.
integer
required
The ID of the note (comment) to update.
integer
required
The internal ID of the project’s issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_LABELUpdates an existing label in a GitLab project by modifying its name, color, description, priority, or archived status. At least one of new_name or color must be provided to perform the update. Use this action when you need to rename a label, change its appearance, update its description, adjust its priority, or archive/unarchive it.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
The new color for the label in 6-digit hex notation with leading ’#’ (e.g., #FFAABB) or CSS color name. Required if new_name is not provided.
boolean
Set to true to mark the label as archived, false to unarchive. Defaults to false.
string
required
The ID or title of the label to update.
string
The new name for the label. Required if color is not provided.
integer
The new priority for the label. Must be greater than or equal to 0, or set to null to remove priority.
string
The new description for the label.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_MERGE_REQUESTUpdates an existing merge request in a GitLab project (title, description, assignees, reviewers, labels, state, etc.). Use this action when you need to modify merge request details, manage assignees/reviewers, update labels, close/reopen merge requests, or configure merge settings like squash or auto-removal of source branch. This action is idempotent and can be called multiple times with the same parameters.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
Title of the merge request.
string
Comma-separated label names to replace the entire label set. Set to empty string to remove all labels.
boolean
Squash commits into a single commit when merging.
string
Comma-separated label names to add without affecting existing labels.
integer
Assignee user ID. Set to 0 to unassign.
string
Description of the merge request.
string ("close" | "reopen")
State event to perform. Use ‘close’ to close the merge request or ‘reopen’ to reopen it.
array
Array of user IDs to assign. Set to empty array to unassign all assignees.
integer
ID of milestone to assign. Set to 0 to unassign milestone.
array
Array of user IDs to set as reviewers. Set to empty array to unassign all reviewers.
string
Comma-separated label names to remove from the merge request.
string
Target branch for the merge request.
boolean
Flag indicating if the discussion is locked. Only project members can comment when locked.
integer
required
Internal ID of the merge request to update.
boolean
Allow commits from members who can merge to the target branch.
boolean
Flag indicating if the source branch should be removed after merge.
boolean
Allow maintainers of the target project to push to the merge request branch (deprecated, use allow_collaboration).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_MERGE_REQUEST_DISCUSSIONResolve or reopen a resolvable merge request discussion thread.

Input Parameters

boolean
required
Set to true to resolve the discussion or false to reopen it.
string
required
The numeric project ID or namespace/project path. URL encoding is handled automatically.
string
required
The ID of the merge request discussion thread.
integer
required
The project-local IID of the merge request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_MERGE_REQUEST_DISCUSSION_NOTEUpdate the content of a merge request thread note, or resolve/reopen it. Set exactly one of body or resolved. An empty resolved value is a no-op. See https://docs.gitlab.com/api/discussions/#update-a-merge-request-thread-note.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
Updated note content. Set exactly one of body or resolved.
integer
required
ID of the thread note to update.
string
True resolves the note; false reopens it; an empty string returns it unchanged. Set exactly one of body or resolved.
string
required
ID of the discussion thread.
integer
required
Project-local merge request IID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_MERGE_REQUEST_DRAFT_NOTEUpdate the content or diff position of a merge request draft note. Draft notes are unpublished and visible only to their author. Omitted position is kept unchanged. This does not publish the note. See https://docs.gitlab.com/api/draft_notes/#update-a-draft-note.

Input Parameters

string
required
ID or unencoded path of the project.
string
New content of the draft note.
object
New diff position; omit to keep the existing position.
integer
required
ID of the draft note to update.
integer
required
Project merge request IID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_MERGE_REQUEST_NOTEUpdate an existing merge request note’s content and optional confidential flag. This edits a published note, not an unpublished draft note or a diff discussion. See https://docs.gitlab.com/api/notes/#update-a-merge-request-note.

Input Parameters

string
required
ID or unencoded path of the project.
string
required
New note content, up to 1,000,000 characters.
integer
required
ID of the note to update; required in the URL.
boolean
Deprecated confidential flag of the note; GitLab defaults to false.
integer
required
Project merge request IID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_MILESTONEUpdates an existing milestone in a GitLab project, allowing you to modify the title, description, dates, or state. Use this action when you need to change milestone details, adjust deadlines, or close/reopen a milestone.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
The new title of the milestone.
string
The new due date of the milestone in YYYY-MM-DD format.
string
The new start date of the milestone in YYYY-MM-DD format.
string
The new description of the milestone.
string ("close" | "activate")
The state event to apply to the milestone. Use ‘close’ to close the milestone or ‘activate’ to reopen it.
integer
required
The ID of the project’s milestone to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_PERSONAL_SNIPPETUpdate an existing personal snippet’s metadata or files. Requires permission to change the snippet. For multi-file snippets, supply files with an action on each entry; prefer files over deprecated content and file_name. See https://docs.gitlab.com/api/snippets/#update-snippet.

Input Parameters

integer
required
ID of the personal snippet to update.
array
File actions, required when updating a snippet with multiple files. Each entry requires action.
string
Title of the snippet.
string
Deprecated: use files instead. Content of a snippet.
string
Deprecated: use files instead. Name of a snippet file.
string ("public" | "private" | "internal")
Snippet visibility. The internal value is unavailable on GitLab.com.
string
Description of the snippet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_PIPELINE_SCHEDULEUpdate a project’s pipeline schedule, which is automatically rescheduled. Only supplied fields are updated. Inputs accept strings, arrays, numbers, or booleans; remove an existing input with its name and destroy=true. See https://docs.gitlab.com/api/pipeline_schedules/#update-a-pipeline-schedule.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
Branch or tag, as a short name or full ref (refs/heads/main or refs/tags/main). Use a full ref if a branch and tag share a name.
string
Cron schedule, for example 0 1 * * *.
boolean
Whether the pipeline schedule is active; false deactivates it.
array
Named pipeline inputs to update; to delete an input, supply its name and destroy=true without a value.
string
Description of the schedule.
string
ActiveSupport::TimeZone or TZInfo::Timezone name, such as Pacific Time (US & Canada) or America/Los_Angeles.
integer
required
ID of the pipeline schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_PIPELINE_SCHEDULE_VARIABLEUpdate an existing variable for a project’s pipeline schedule. Supply value, variable_type, or both; omitted fields are not sent. See https://docs.gitlab.com/api/pipeline_schedules/#update-a-variable-for-a-pipeline-schedule.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
required
Key of the variable to update.
string
New variable value. Omit to leave the value unchanged.
string ("env_var" | "file")
Variable type: env_var (GitLab default) or file. Omit to leave unchanged.
integer
required
ID of the pipeline schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_PROJECTUpdate an existing GitLab project’s settings, visibility, features, and CI/CD configuration. Requires Maintainer or Owner; some settings require Owner, administrator access, a paid tier, or a newer GitLab version. Only supplied settings are changed. Topics replace existing topics. Avatar accepts an image URL to upload. To clear an array, send an empty array in a separate call without avatar.

Input Parameters

string
required
Project ID or unencoded namespaced path, such as group/project.
string
Project name.
string
Custom repository path for the project.
string
URL of an image file to download and upload as the project avatar.
boolean
Enable pull mirroring. Premium/Ultimate.
array
Replaces all existing project topics.
array
Deprecated since 14.0; use topics. Replaces existing tags.
string
URL the repository was imported from; include authentication in the URL for private HTTP repositories.
string ("private" | "internal" | "public")
Project visibility.
string
Short project description.
boolean
Enable Large File Storage.
boolean
Allow non-members to view jobs.
boolean
Deprecated; use builds_access_level.
string ("merge" | "rebase_merge" | "ff")
Merge method: merge commit, semi-linear, or fast-forward.
boolean
Deprecated; use wiki_access_level.
integer
Maximum job runtime in seconds.
boolean
Deprecated; use public_jobs.
string ("never" | "always" | "default_on" | "default_off")
Squash behavior for merge requests.
string
Path to the CI configuration file.
string
Default branch name.
boolean
Enable email notifications.
boolean
Deprecated; use issues_access_level.
integer
User responsible for pull mirror events. Administrators only; Premium/Ultimate.
boolean
Deprecated; use emails_enabled.
string
Default issue description in GitLab Flavored Markdown. Premium/Ultimate.
boolean
Deprecated since 17.10; use package_registry_access_level.
boolean
Deprecated; use snippets_access_level.
string ("disabled" | "private" | "enabled")
Wiki visibility.
string
Git strategy, default fetch.
integer
Maximum individual job artifact size in megabytes.
string ("disabled" | "private" | "enabled" | "public")
Pages visibility. Public requires instance/group permission and a private/internal project; enabled is unavailable for private projects when Pages access control is on.
string
Repository storage shard. Administrators only.
boolean
Enable Auto DevOps.
string ("disabled" | "private" | "enabled")
Pipeline visibility.
boolean
Separate caches by branch protection status.
string ("disabled" | "private" | "enabled")
Issue visibility.
integer
Default shallow clone revision count.
boolean
Publish the project to the CI/CD Catalog. Requires Owner.
string ("disabled" | "private" | "enabled")
Fork visibility.
boolean
Keep the latest artifact.
boolean
Enable merge trains.
string ("disabled" | "private" | "enabled")
Application performance monitoring visibility.
boolean
Enable Service Desk; returned value also depends on instance incoming email configuration.
boolean
Enable group runners.
string
Template for branch names suggested from issues.
string
Merge commit message template.
boolean
Pull mirroring triggers builds. Premium/Ultimate.
string ("disabled" | "private" | "enabled")
Release visibility.
string ("disabled" | "private" | "enabled")
Snippet visibility.
string ("disabled" | "private" | "enabled")
Analytics visibility.
integer
Default approval count. Deprecated since 16.0; use the merge request approvals API. Premium/Ultimate.
boolean
Deprecated; use merge_requests_access_level.
boolean
Target fork merge requests to this project instead of upstream.
boolean
Allow users to request membership.
boolean
Enable instance runners.
string
Squash commit message template.
boolean
Enable merged results pipelines.
string
Default merge request description in GitLab Flavored Markdown. Premium/Ultimate.
string ("allow_bypass" | "enforce_for_all_users" | "enforce_with_owner_override")
Merge train enforcement; only effective with merge trains enabled.
string ("disabled" | "private" | "enabled")
Repository visibility.
boolean
Rebase the source before fast-forward or semi-linear merge.
boolean
Allow flows to run in the project.
string ("disabled" | "private" | "enabled")
Environment visibility.
string
Default merge request title template.
string ("disabled" | "private" | "enabled")
Requirements management visibility.
boolean
Show default emoji reactions.
string
Commit message for merge request suggestions.
boolean
Deprecated; use container_registry_access_level.
string ("disabled" | "private" | "enabled")
Feature flag visibility.
string ("no_one_allowed" | "developer" | "maintainer" | "owner")
Minimum role to manage feature flags. Owner required to change away from owner or no_one_allowed.
string ("continuous" | "manual" | "timed_incremental")
Auto Deploy strategy.
boolean
Auto-close referenced issues on the default branch.
string ("disabled" | "private" | "enabled")
Infrastructure management visibility.
string ("disabled" | "private" | "enabled")
Merge request visibility.
string ("disabled" | "private" | "enabled")
Model registry visibility.
boolean
Enable automatic GitLab Duo merge request reviews. Ultimate.
boolean
Enable SAST vulnerability resolution workflow. Requires Security Manager, Maintainer, or Owner.
string ("disabled" | "code_owners")
Automatic reviewer assignment strategy. Premium/Ultimate; dap_powered is no longer accepted since 19.4.
string
Auto-cancel pending pipelines: enabled or disabled, not a boolean.
boolean
Display manually defined pipeline variables on the details page.
boolean
Prevent outdated deployment jobs.
boolean
Enable SAST false-positive detection. Requires Security Manager, Maintainer, or Owner.
integer
Maximum parallel pipelines per merge train.
string ("disabled" | "private" | "enabled" | "public")
Package registry visibility.
integer
Delete pipelines older than this number of seconds.
boolean
Enforce authorization checks on uploads.
string ("disabled" | "private" | "enabled")
Machine learning experiment visibility.
boolean
Only mirror protected branches. Premium/Ultimate.
boolean
Allow users and tokens read-only access to security policy configurations. Ultimate.
boolean
Allow merging with skipped jobs.
string ("disabled" | "private" | "enabled")
Container registry visibility.
boolean
Enable secret detection false-positive detection. Requires Security Manager, Maintainer, or Owner.
boolean
Allow merge train merges without waiting for pipelines.
boolean
Control merge request pipeline access to protected variables and runners.
boolean
Deprecated since 17.7; use ci_pipeline_variables_minimum_override_role.
array
ID token sub components. First: project_path, project_id, job_project_path, job_project_id, source_project_path or source_project_id. Additional: ref_type, ref, ref_protected, environment_protected, deployment_tier. Version-dependent.
boolean
Skip branch pipelines for merge requests.
boolean
Require an associated Jira issue for merge requests. Ultimate.
boolean
Default new merge requests to delete the source branch.
boolean
Enable signing commits created in the GitLab UI. GitLab.com only.
boolean
Enable GitLab Duo approvals and change requests. Ultimate.
boolean
Resolve discussions on diff lines changed by a push.
boolean
Pull mirrors overwrite diverged branches. Premium/Ultimate.
Show a merge request link when pushing from the command line.
string ("disabled" | "private" | "enabled")
Security and compliance visibility.
boolean
Require successful jobs before merging.
boolean
Allow retries for rollback deployments.
string ("developer" | "maintainer" | "no_one")
Minimum role to cancel pipelines/jobs. Premium/Ultimate.
object
Image cleanup policy settings.
boolean
Allow job tokens to push to this repository.
boolean
Allow pipeline triggerers to approve deployments. Premium/Ultimate.
boolean
Warn about potentially unwanted characters.
string ("owner" | "maintainer" | "developer" | "no_one_allowed")
Minimum role to override pipeline variables.
string
External authorization classification label. Premium/Ultimate.
boolean
Block merges until all status checks pass. Ultimate.
boolean
Allow fork merge request pipelines in the parent project.
boolean
Require all discussions to be resolved before merging.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_PROJECT_DEPLOY_KEYChange a project’s deploy-key title or push permission. Supply at least one of title or can_push. See https://docs.gitlab.com/api/deploy_keys/#update-deploy-key.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
New deploy-key title. Supply title or can_push.
string
required
ID of the deploy key to update.
boolean
Whether the deploy key can push to the project. Supply can_push or title.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_PROJECT_ISSUETool 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.

Input Parameters

string
required
The global ID or URL-encoded path of the project.
string
The title of the issue.
string
Comma-separated label names to replace the entire label set. Set to empty string to remove all labels.
integer
The weight of the issue. Valid values are greater than or equal to 0. Premium and Ultimate only.
integer
ID of the epic to add the issue to. Valid values are greater than or equal to 0. Premium and Ultimate only.
string
The due date. Date time string in the format YYYY-MM-DD.
integer
required
The internal ID of the project’s issue.
string
Comma-separated label names to add to the issue without affecting existing labels.
string ("issue" | "incident" | "test_case" | "task")
The type of issue. One of ‘issue’, ‘incident’, ‘test_case’, or ‘task’.
string
When the issue was updated. Date time string, ISO 8601 formatted. Requires administrator or project/group owner rights.
string
The description of the issue. Limited to 1,048,576 characters.
string ("close" | "reopen")
State event to perform on the issue. Use ‘close’ to close the issue or ‘reopen’ to reopen it.
array
The IDs of the users to assign the issue to. Set to [0] or provide empty array to unassign all.
boolean
Set an issue to be confidential.
integer
The global ID of a milestone to assign to the issue. Set to 0 to unassign milestone.
string
Comma-separated label names to remove from the issue.
boolean
Flag indicating if the issue’s discussion is locked. If the discussion is locked, only project members can add or edit comments.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_PROJECT_MEMBERUpdate a project member’s access level, expiration, or custom role. Promotions may be queued for administrator approval rather than applied immediately. See https://docs.gitlab.com/api/project_members/#update-a-member-of-a-project.

Input Parameters

string
required
ID or unencoded namespace path of the project.
integer
required
User ID of the member to update.
string
Membership expiration date in YEAR-MONTH-DAY format.
integer ("10" | "15" | "20" | "25" | "30" | "40" | "50")
required
Access level: Guest (10), Planner (15), Reporter (20), Security Manager (25), Developer (30), Maintainer (40), or Owner (50).
integer
Ultimate only: custom member role ID. If no value is specified, GitLab removes all custom roles.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_PROJECT_SNIPPETUpdate a project snippet’s metadata or files. Requires permission to change existing snippets. Multi-file snippet updates must use files, with an action on every entry. Prefer files over deprecated content and file_name. See https://docs.gitlab.com/api/project_snippets/#update-a-snippet.

Input Parameters

string
required
ID or unencoded namespace path of the project.
array
Snippet file actions. Required for updates to snippets with multiple files; each entry requires action.
string
Title of the snippet.
string
Deprecated: use files instead. Content of a snippet.
string
Deprecated: use files instead. Name of a snippet file.
integer
required
ID of the project’s snippet.
string ("public" | "private" | "internal")
Snippet visibility. The internal value is unavailable on GitLab.com.
string
Description of the snippet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_PROJECT_VARIABLEUpdate a project’s CI/CD variable by key with a required new value. Use filter.environment_scope to select an existing variable when keys repeat; environment_scope sets the variable’s new scope instead. See https://docs.gitlab.com/api/project_level_variables/#update-a-variable.

Input Parameters

string
required
Project ID or unencoded namespace/project path.
string
required
Key of the project CI/CD variable to update.
boolean
Whether the value is raw text. GitLab defaults to true; false expands variables in the value.
string
required
New value of the variable.
object
Select the existing environment scope when variables share a key.
boolean
Whether the variable is masked.
boolean
Whether the variable is protected.
string
Description of the variable. GitLab defaults to null.
string ("env_var" | "file")
Variable type: env_var (GitLab default) or file.
string
New environment scope of the variable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_PROJECT_WIKI_PAGEUpdate a project wiki page’s content, title, and optional markup format. Provide content or title (or both). Changing the title can change the page slug. See https://docs.gitlab.com/api/wikis/#update-a-wiki-page.

Input Parameters

string
required
ID or unencoded namespace path of the project.
string
required
Unencoded unique wiki page slug, such as dir/page_name.
string
Wiki page title. Required when content is omitted.
string ("markdown" | "rdoc" | "asciidoc" | "org")
Wiki page format. GitLab documents markdown as the default.
string
Wiki page content. Required when title is omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_RELEASEUpdate a project release’s name, description, milestones, or release date. Requires Developer access. Omitted fields remain unchanged; pass an empty milestones array to remove all milestone associations. See https://docs.gitlab.com/api/releases/#update-a-release.

Input Parameters

string
required
ID or unencoded path of the project.
string
New release name.
string
required
Git tag associated with the release.
array
Milestone titles to associate; [] removes all associations. Group milestones require Premium and must belong to the project’s group, not ancestor groups.
string
New release description, supporting Markdown.
string
Date when the release is or was ready, in ISO 8601 format (2019-03-15T08:00:00Z).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_REPOSITORY_FILEUpdates an existing file in a GitLab repository. Commits the changes to the specified branch with the provided commit message. Use this action when you need to modify file contents, change file permissions, or update files in a specific branch. Note that if concurrent modifications occur (detected via last_commit_id), the update will fail.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
required
Name of the branch to commit to. The commit is added to this branch.
string
required
The new content of the file.
string ("text" | "base64")
Change encoding to base64. Default is text.
string
required
URL-encoded full path to the file in the repository (e.g., lib%2Fclass%2Erb or path/to/file.txt).
string
The name of the commit author.
string
The email address of the commit author.
string
Name of the branch to start the new commit from. If not provided, defaults to the value of branch.
string
required
Commit message describing the changes.
string
Last known file commit ID. Used to detect concurrent modifications.
boolean
Enable or disable the execute flag on the file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPDATE_WEBHOOKUpdates an existing project webhook’s URL and optionally its event triggers, SSL verification, and authentication token. Use it to change the endpoint or security settings, adjust notifications, or rotate the token; the webhook URL is required even when updating other settings.

Input Parameters

string
required
The ID or URL-encoded path of the project.
string
required
The webhook URL to which GitLab will send HTTP POST requests when events occur.
string
Secret token for authenticating webhook requests. GitLab includes this in the X-Gitlab-Token header.
integer
required
The ID of the webhook to update.
boolean
Trigger webhook on job/build events.
boolean
Trigger webhook on comment/note events.
boolean
Trigger webhook on push events.
boolean
Trigger webhook on wiki page events.
boolean
Trigger webhook on issue events (create, update, close).
boolean
Trigger webhook on pipeline events.
boolean
Trigger webhook on tag push events.
boolean
Trigger webhook on merge request events (create, update, merge, close).
boolean
Enable SSL certificate verification when delivering webhook payloads.
string
Filter push events by branch name (supports wildcards). Only triggers webhook for pushes to matching branches.
boolean
Trigger webhook on confidential issue events.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPLOAD_GROUP_WIKI_ATTACHMENTUpload a file to the uploads folder in a group’s wiki repository. Requires a GitLab Premium or Ultimate group. See https://docs.gitlab.com/api/group_wikis/#upload-an-attachment-to-the-wiki-repository.

Input Parameters

string
required
ID or unencoded namespace path of the group.
object
required
Attachment to upload to the wiki.
string
Branch name; defaults to the wiki repository default branch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_UPLOAD_PROJECT_WIKI_ATTACHMENTUpload a file to the uploads folder in a project’s wiki repository. See https://docs.gitlab.com/api/wikis/#upload-an-attachment-to-the-wiki-repository.

Input Parameters

string
required
ID or unencoded namespace path of the project.
object
required
Attachment to upload to the wiki.
string
Branch name; defaults to the wiki repository default branch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_VALIDATE_CI_CONFIGURATIONValidate supplied GitLab CI/CD YAML without creating a pipeline.

Input Parameters

string
Branch or tag context used when dry_run is true.
string
required
The GitLab CI/CD YAML content to validate.
boolean
Whether to simulate pipeline creation during validation.
string
required
The numeric ID or namespace/project path of the project. URL-encoding is handled automatically.
boolean
Whether to include resolved jobs in the lint result.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GITLAB_VALIDATE_CREDENTIALValidates the authentication credentials by retrieving the currently authenticated user’s information. Use this action when you need to verify that the API token or credentials are valid and active. Returns the authenticated user’s profile details if credentials are valid.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not