`HTTP 410` version promise is untestable

Open
#7,054 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
openapi
Domain
api

Research direction

Start with the linked API versioning documentation and compare the listed versions, 2022-11-28 and 2026-03-10, with the requested 2008-04-01 version. Determine whether this repository can represent a version that returns HTTP 410 for API calls; done would make that expired-version response testable for GitHub and its consumers.

Written by the indexing model from the issue text.

Description

feature

https://docs.github.com/en/rest/about-the-rest-api/api-versions?apiVersion=2026-03-10#specifying-an-api-version

If you specify an API version that is no longer supported, you will receive a 410 Gone response.

There's stuff that talks about a HTTP 410 response, but I don't know how to trigger that.

There are currently two api versions:

  • 2022-11-28
  • 2026-03-10

It'd be really nice if you introduced another api version:

  • 2008-04-01

(It could be 2008-01-01, 2008-02-01, 2008-02-07, or 2008-04-09, but 04-01 seems nicest)

And have it return HTTP 410 for any api calls. That'd make it easy for people to imagine calling an endpoint and getting an HTTP 410 back from github based on a versioned api expiring. It'd mean that both GitHub and consumers of GitHub could test this codepath instead of relying on hallucinations.

Dominant language
No language data
Stars
1.6k
Forks
342
Avg merge
3h 33m
Merged PRs (30d)
51

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from github/rest-api-description

All issues in github/rest-api-description

Similar issues

More Backend & API Design issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.