You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Nov 1, 2017. It is now read-only.
Now that the GitHub API is[serving the v3 media type by default][v3-default], we are deprecating the legacy[beta media type][beta].
9
+
10
+
We will eventually remove support for the beta media type, but we have no official retirement date to annouce at the moment. When the time comes, rest assured that we'll announce the retirement with plenty of notice. In the meantime, existing API clients that rely on the beta media type should start making plans to migrate to v3. The beta media type differs from v3 in[just a few places][differences]. In most cases, migrating an application from the beta media type to the v3 media type is smooth and painless.
11
+
12
+
As always, if you have any questions, please[get in touch][contact].
Copy file name to clipboardExpand all lines: content/v3/versions.md
+16-8Lines changed: 16 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Versions | GitHub API
3
3
---
4
4
#Versions
5
5
6
-
There are two stable versions of the GitHub API: the[v3](#v3) version and thelegacy[beta](#beta) version. There are just a few[differences between these two versions](#differences-from-beta-version).
6
+
There are two stable versions of the GitHub API: the[v3](#v3) version and thedeprecated[beta](#beta) version. There are just a few[differences between these two versions](#differences-from-beta-version).
7
7
8
8
By default, all requests receive the v3 version. We encourage you to[request a specific version via the`Accept` header](/v3/media/#request-specific-version).
9
9
@@ -92,20 +92,28 @@ The recommendations below will help you prepare your application for the next ma
92
92
: Recommendation: Do not use this attribute. It is obsolete.
93
93
94
94
95
-
#beta
95
+
#beta (Deprecated) {#beta}
96
+
97
+
The[beta API](/v3) is deprecated. Its current functionality is stable and unchangeable. Please[file a support issue][support] if you have problems.
96
98
97
99
<divclass="alert">
98
100
<p>
99
101
<strong>Note</strong>: We recommend using the <a href="#v3">v3 API</a>
100
-
instead of the legacy beta version of the API. We will eventually retire the
101
-
beta version, but we have no official retirement date to annouce at the
102
-
moment. When the time comes, rest assured that we'll announce the retirement
103
-
with plenty of notice.
102
+
instead of the deprecated beta version of the API.
103
+
</p>
104
+
<p>
105
+
The beta media type differs from the v3 media type in
106
+
<a href="#differences-from-beta-version">just a few places</a>. In most
107
+
cases, migrating an application from the beta media type to the v3 media
108
+
type is smooth and painless.
109
+
</p>
110
+
<p>
111
+
We will eventually retire the beta version, but we have no official
112
+
retirement date to annouce at the moment. When the time comes, rest assured
113
+
that we'll announce the retirement with plenty of notice.
104
114
</p>
105
115
</div>
106
116
107
-
The[beta API](/v3) is stable and unchangeable. Please[file a support issue][support] if you have problems.