[Schema Inaccuracy] the /repos/{owner}/{repo}/releases/latest endpoint can return a 404

[ae-ou]

Schema Inaccuracy

The /repos/{owner}/{repo}/releases/latest endpoint returns a 404 if you call it against a repository that has no releases (e.g. a newly created repo). The documentation for this endpoint only lists 200 as a potential response code.

This data block is also returned in the event of a 404:

{
    message: 'Not Found',
    documentation_url: 'https://docs.github.com/rest/releases/releases#get-the-latest-release',
    status: '404'
}

It's worth noting that the page that the documentation_url points to doesn't mention 404 response codes.

Expected

The documentation should list 404 as a possible response code.

Reproduction Steps

1. Find a repo that has no releases against it, or create a brand new repo for the sake of testing.
2. Call the endpoint (populate the owner and repo path placeholders, and pass in an API token if the repo is private).
3. Observe that a 404 response is returned.

[shiftkey]

@ae-ou thanks for the report! I've reached out to the team who maintains that API to confirm this is behaviour that should be documented.

[nickfloyd]

Please let us know if this work is still needed. We're trying to follow up on any older issues to make sure they get properly routed.