summaryrefslogtreecommitdiff
path: root/data/deprecations/14-8-runner-api-status-filter-does-accept-active-or-paused.yml
blob: ce372a36f69923c2152fa432865111b9bff79e56 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
- title: "GraphQL API Runner will not accept `status` filter values of `active` or `paused`"
  announcement_milestone: "14.8"  # The milestone when this feature was first announced as deprecated.
  removal_milestone: "16.0"
  breaking_change: true
  body: |  # Do not modify this line, instead modify the lines below.
    The GitLab Runner GraphQL endpoints will stop accepting `paused` or `active` as a status value in GitLab 16.0.

    A runner's status will only relate to runner contact status, such as: `online`, `offline`.
    Status values `paused` or `active` will no longer be accepted and will be replaced by the `paused` query parameter.

    When checking for paused runners, API users are advised to specify `paused: true` as the query parameter.
    When checking for active runners, specify `paused: false`.

    The REST API endpoints will follow in the same direction in a future REST v5 API, however the new `paused`
    status value can be used in place of `active` since GitLab 14.8.
  stage: Verify
  tiers: [Core, Premium, Ultimate]
  issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/351109
  documentation_url: https://docs.gitlab.com/ee/api/graphql/reference/#queryrunners