Sync changes from upstream repository

Hubot · Hubot · commit eda792e780db · 2015-02-18T15:52:20.000Z
diff --git a/content/changes/2015-02-18-new-releases-api-methods.md b/content/changes/2015-02-18-new-releases-api-methods.md
@@ -0,0 +1,21 @@
+---
+kind: change
+title: New Releases API methods
+created_at: 2015-02-18
+author_name: pengwynn
+---
+
+We've added two new methods to the [Releases API][]. You can now get the [latest published release][latest] for a repository.
+
+    GET /repos/:owner/:repo/releases/latest
+
+You can also get a [release by tag name][by-tag].
+
+    GET /repos/:owner/:repo/releases/tags/:tag
+
+If you have any questions or feedback, please [get in touch][contact].
+
+[Releases API]: /v3/repos/releases/
+[latest]: /v3/repos/releases/#get-the-latest-release
+[by-tag]: /v3/repos/releases/#get-a-release-by-tag-name
+[contact]: https://github.com/contact?form[subject]=New+Releases+API+methods
diff --git a/content/v3/repos/releases.md b/content/v3/repos/releases.md
@@ -40,6 +40,28 @@ Git tags that have not been associated with a release.
 <%= headers 200 %>
 <%= json :release %>
 
+## Get the latest release
+
+View the latest published release for the repository.
+
+    GET /repos/:owner/:repo/releases/latest
+
+### Response
+
+<%= headers 200 %>
+<%= json :release %>
+
+## Get a release by tag name
+
+Get a release with the specified tag. Users must have push access to the repository to view draft releases.
+
+    GET /repos/:owner/:repo/releases/tags/:tag
+
+### Response
+
+<%= headers 200 %>
+<%= json :release %>
+
 
 ## Create a release
 
