View as Markdown
GitLab icon

GitLab ACTION

Update Epic

Updates an epic. See the documentation
  • Action
  • Writes data
  • Destructive
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's GitLab account once, then configure and run Update Epic from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "gitlab-update-epic",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    gitlab: { authProvisionId: "apn_xxxxxxx" },
    groupId: "Group ID",
    epicIid: "Epic Internal ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Update Epic inputs
Property Type Description
groupId Group ID string
Select a Group or use a custom Group ID. You must be an Owner of this group
Required Dynamic
epicIid Epic Internal ID string
Required Dynamic
add_labels Add labels string[]
The comma-separated list of labels
Optional Dynamic
confidential Confidential boolean
Whether the epic should be confidential
Optional
description Description string
The description of the issue
Optional
labels Labels string[]
Comma-separated label names for an issue. Set to an empty string to unassign all labels.
Optional Dynamic
parent_id Parent Id string
The ID of a parent epic. Available in GitLab 14.6 and later
Optional Dynamic
remove_labels Remove labels string[]
Comma-separated label names to remove from an issue.
Optional Dynamic
stateEvent State Event string
The state event of an issue. Set close to close the issue and reopen to reopen it
Optional
title Title string
The title of an epic
Optional
updated_at Updated at string
When the epic was updated. Date time string, ISO 8601 formatted, for example 2016-03-11T03:45:40Z . Requires administrator or project/group owner privileges (available in GitLab 13.5 and later)
Optional
color Color string
The color of the epic. Introduced in GitLab 14.8, behind a feature flag named epic_highlight_color (disabled by default)
Optional
start_date_is_fixed Start Date Is Fixed boolean
Whether start date should be sourced from start_date_fixed or from milestones (in GitLab 11.3 and later)
Optional
due_date_is_fixed Due Date Is Fixed boolean
Whether due date should be sourced from due_date_fixed or from milestones (in GitLab 11.3 and later)
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
gitlab-update-epic
Version
0.0.5
App
GitLab
Authentication
OAuth
Read-only
No
Destructive
Yes
Open world
Yes