Skip to main content
Use GitLab when your workflow needs to read or change projects, issues, merge requests, repository files, or pipelines. It works well when later steps can provide project IDs, issue IIDs, branch names, SHAs, or job IDs.

​
Configuration

Before you configure this step, connect GitLab in Integrations for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to Integrations instead of the account selector.

​
Arguments form

When you select an action, the Arguments section renders a form driven by the action’s input schema. Fields that refer to existing records include dropdown pickers. Switch to the Raw JSON tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

​
Common actions

Destructive actions, such as deleting records, are not available in the workflow action picker.

​
Output

This step stores the GitLab response as the step output. The shape of the response depends on the action. Use the full output reference in later steps:

​
Example

  1. Open Integrations and connect GitLab if you have not already done that.
  2. Add a GitLab step to your workflow.
  3. Select a connected account in Authentication.
  4. Choose Get Current User in Action.
  5. Fill in the required fields. Use Insert Variable to reference an earlier step’s output for any field value.
  6. Click Run in the step header to test the action, then review the returned payload in Output.

​
Use cases

​
Create an issue from a form

  1. Get Current User
  2. Get Project
  3. Create Project Issue

​
Review a merge request

  1. List Merge Requests
  2. Get Merge Request
  3. Get MR Approvals

​
Update code and run CI

  1. Get Repository File
  2. Update Repository File
  3. Create Pipeline
  4. List Pipeline Jobs

​
Notes

  • This step depends on a connected GitLab integration in your workspace.
  • The workflow action picker shows a curated set of actions. Agents with the GitLab tool can use more of them.
  • The sign-in screen may show third-party authorization branding.

​
Using GitLab as an Agent Tool

You can also add GitLab as a tool in the Agent Editor. Open the agent, click Add tool, and select GitLab. In the tool settings panel, choose the connected account the agent should use. The agent calls GitLab actions when they are relevant to the conversation. See also: Integrations, Creating and Editing, and Testing and Iteration