Skip to main content

group_label

Gets or lists a group_label resource.

Overview​

Namegroup_label
TypeResource
Idgitlab.groups.group_label

Fields​

The following fields are returned by SELECT queries:

GraphQL response envelope

NameDatatypeDescription
idstringGlobal ID of the label.
archivedbooleanIndicates the label is archived.
colorstringBackground color of the label.
created_atstringWhen the label was created.
descriptionstringDescription of the label (Markdown rendered as HTML for caching).
lock_on_mergebooleanIndicates this label is locked for merge requests that have been merged.
text_colorstringText color of the label.
titlestringContent of the label.
updated_atstringWhen the label was last updated.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectfull_path, title, hostLabel available on the group. Generated from the GitLab GraphQL schema field Group.label (Label).

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
full_pathstringFull path of the group, for example gitlab-org
hoststringGitLab host, with an optional port (default gitlab.com). Resolved from the GITLAB_HOST environment variable when it is set (x-stackQL-envVar); a WHERE host value always takes precedence. Self-managed instances: the provider is generated from the gitlab.com schema, so older instances may reject fields they do not serve. (default: gitlab.com, x-stackQL-envVar: GITLAB_HOST)
titlestringTitle of the label.

SELECT examples​

Label available on the group. Generated from the GitLab GraphQL schema field Group.label (Label).

SELECT
id,
archived,
color,
created_at,
description,
lock_on_merge,
text_color,
title,
updated_at
FROM gitlab.groups.group_label
WHERE full_path = '{{ full_path }}' -- required
AND title = '{{ title }}' -- required
AND host = '{{ host }}' -- required (defaults to gitlab.com; or set GITLAB_HOST)
;