Skip to main content

board_list

Gets or lists a board_list resource.

Overview​

Nameboard_list
TypeResource
Idgitlab.boards.board_list

Fields​

The following fields are returned by SELECT queries:

GraphQL response envelope

NameDatatypeDescription
idstringID (global ID) of the list.
collapsedbooleanIndicates if the list is collapsed for the user.
issues_countintegerCount of issues in the list.
limit_metricstringCurrent limit metric for the list. (all_metrics, issue_count, issue_weights)
list_typestringType of the list.
max_issue_countintegerMaximum number of issues in the list.
max_issue_weightintegerMaximum weight of issues in the list.
milestoneobjectMilestone identity (id, title)
positionintegerPosition of list within the board.
titlestringTitle of the list.
total_issue_weightstringTotal weight of all issues in the list, encoded as a string.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectid, hostFind an issue board list. Generated from the GitLab GraphQL schema field Query.boardList (BoardList).

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)
idstringGlobal ID of the list.

SELECT examples​

Find an issue board list. Generated from the GitLab GraphQL schema field Query.boardList (BoardList).

SELECT
id,
collapsed,
issues_count,
limit_metric,
list_type,
max_issue_count,
max_issue_weight,
milestone,
position,
title,
total_issue_weight
FROM gitlab.boards.board_list
WHERE id = '{{ id }}' -- required
AND host = '{{ host }}' -- required (defaults to gitlab.com; or set GITLAB_HOST)
;