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

Abierto Apto para principiantes
#7,163 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
72/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
openapi

Línea de trabajo

Comienza en descriptions/api.github.com/api.github.com.json comparando las rutas de obsolescencia existentes de los runners de organización y repositorio con la ruta de enterprise descrita en el changelog del 2026-09-03. Comprueba el encabezado de documentación correspondiente y el enlace de error específico de la ruta; se considera terminado cuando la descripción y el changelog/la documentación representan de forma coherente los scopes compatibles, y el enlace de enterprise se resuelve correctamente si se conserva ese scope.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
Sin datos de lenguaje
Estrellas
1.6k
Forks
342
Merge medio
3 h 33 min
PR fusionados (30 d)
51

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de github/rest-api-description

Todos los issues de github/rest-api-description

Issues similares

Más issues de Backend & API Design

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.