Runner deprecations: enterprise scope is in the changelog and the 404 handler but not in the description

オープン 初心者向け
#7,163 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
72/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
活発
技術スタック
openapi
領域
api, documentation

調査の方向性

descriptions/api.github.com/api.github.com.json で、既存の organization および repository runner の廃止パスと、2026-09-03 の changelog に記載された enterprise route を比較することから始めます。対応するドキュメントの見出しと、route 固有のエラーリンクを確認します。description と changelog/docs がサポート対象の scope を一貫して表し、その scope を維持する場合に enterprise リンクが正しく解決されれば完了です。

索引モデルが issue の本文から書いたものです。

説明

feature
Description

The 2026-09-03 changelog
says the runner version end-of-life endpoint is callable "at the repository,
organization, or enterprise level". descriptions/api.github.com/api.github.com.json
at 1.1.4 has the /orgs/{org}/ and /repos/{owner}/{repo}/ deprecations paths and no
/enterprises/{enterprise}/actions/runners* path of any kind.

A missing path alias would normally be the README's "only the most common path is
described". This looks different, because the operation name exists outside the
description and resolves to nothing. The enterprise route 404s with a route-specific
documentation_url, where an unrouted sibling gets the generic one:

$ curl -s -H "Authorization: Bearer $TOKEN" \
    https://api.github.com/enterprises/SLUG/actions/runners/deprecations/2.335.1
{"message":"Not Found","documentation_url":"https://docs.github.com/rest/actions/self-hosted-runners#get-runner-version-end-of-life-schedule-for-an-enterprise","status":"404"}

$ curl -s -H "Authorization: Bearer $TOKEN" \
    https://api.github.com/repos/OWNER/REPO/actions/runners/nonsense-route/2.335.1
{"message":"Not Found","documentation_url":"https://docs.github.com/rest","status":"404"}

That anchor does not exist. The docs page has the organization and repository
headings and no enterprise one, so the link lands at the top of the page. So
get-runner-version-end-of-life-schedule-for-an-enterprise is known to the error
handler and absent from both the description and the page it points at. Clients
generating from the description cannot reach enterprise scope, and clients following
the changelog have nothing to call.

Expected

Either the enterprise paths are added to the api.github.com description, or the
2026-09-03 changelog is corrected to say repository and organization only.

主要言語
言語のデータがありません
スター
1.6k
フォーク
342
平均マージ
3時間 33分
マージ済み PR(30日)
51

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

github/rest-api-description のほかの issue

github/rest-api-description の issue をすべて見る

似ている issue

Backend & API Design の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。