Skip to main content

milestone

Gets or lists a milestone resource.

Overview​

Namemilestone
TypeResource
Idgitlab.projects.milestone

Fields​

The following fields are returned by SELECT queries:

GraphQL response envelope

NameDatatypeDescription
idstringID of the milestone.
created_atstringTimestamp of milestone creation.
descriptionstringDescription of the milestone.
due_datestringTimestamp of the milestone due date.
expiredbooleanExpired state of the milestone (a milestone is expired when the due date is past the current date). Defaults to false when due date has not been set.
group_objectGroup identity (id, full_path, name)
group_milestonebooleanIndicates if milestone is at group level.
iidstringInternal ID of the milestone.
projectobjectProject identity (id, full_path, name)
project_milestonebooleanIndicates if milestone is at project level.
start_datestringTimestamp of the milestone start date.
statestringState of the milestone. (active, closed)
subgroup_milestonebooleanIndicates if milestone is at subgroup level.
titlestringTitle of the milestone.
upcomingbooleanUpcoming state of the milestone (a milestone is upcoming when the start date is in the future). Defaults to false when start date has not been set.
updated_atstringTimestamp of last milestone update.
web_pathstringWeb path of the milestone.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectid, hostFind a milestone. Generated from the GitLab GraphQL schema field Query.milestone (Milestone).

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
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)
idstringFind a milestone by its ID.

SELECT examples​

Find a milestone. Generated from the GitLab GraphQL schema field Query.milestone (Milestone).

SELECT
id,
created_at,
description,
due_date,
expired,
group_,
group_milestone,
iid,
project,
project_milestone,
start_date,
state,
subgroup_milestone,
title,
upcoming,
updated_at,
web_path
FROM gitlab.projects.milestone
WHERE id = '{{ id }}' -- required
AND host = '{{ host }}' -- required (defaults to gitlab.com; or set GITLAB_HOST)
;