debian-mirror-gitlab/data/deprecations/15-7-deprecate-api-v4-runner-registration-token-reset-endpoints.yml

- title: "Support for REST API endpoints that reset runner registration tokens"  # (required) The name of the feature to be deprecated
  announcement_milestone: "15.7"  # (required) The milestone when this feature was first announced as deprecated.
  removal_milestone: "17.0"  # (required) The milestone when this feature is planned to be removed
  removal_date: "2024-04-22"
  breaking_change: true  # (required) If this deprecation is a breaking change, set this value to true
  reporter: pedropombeiro  # (required) GitLab username of the person reporting the deprecation
  stage: Verify  # (required) String value of the stage that the feature was created in. e.g., Growth
  issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/383341  # (required) Link to the deprecation issue in GitLab
  body: |  # (required) Do not modify this line, instead modify the lines below.
    The support for runner registration tokens is deprecated. As a consequence, the REST API endpoints to reset a registration token are also deprecated and will
    be removed in GitLab 17.0.
    The deprecated endpoints are:

    - `POST /runners/reset_registration_token`
    - `POST /projects/:id/runners/reset_registration_token`
    - `POST /groups/:id/runners/reset_registration_token`

    We plan to implement a new method to bind runners to a GitLab instance
    as part of the new [GitLab Runner token architecture](https://docs.gitlab.com/ee/architecture/blueprints/runner_tokens/).
    The work is planned in [this epic](https://gitlab.com/groups/gitlab-org/-/epics/7633).
    This new architecture introduces a new method for registering runners and will eliminate the legacy
    [runner registration token](https://docs.gitlab.com/ee/security/token_overview.html#runner-registration-tokens).
    From GitLab 17.0 and later, the runner registration methods implemented by the new GitLab Runner token architecture will be the only supported methods.
  end_of_support_milestone: "17.0"  # (optional) Use "XX.YY" format. The milestone when support for this feature will end.
  tiers:  # (optional - may be required in the future) An array of tiers that the feature is available in currently.  e.g., [Free, Silver, Gold, Core, Premium, Ultimate]
  documentation_url: https://docs.gitlab.com/ee/api/runners.html#register-a-new-runner  # (optional) This is a link to the current documentation page