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.
Copy file name to clipboardExpand all lines: content/v3/repos/releases.md
+10-4Lines changed: 10 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,6 +15,10 @@ will receive published releases only.
15
15
16
16
GET /repos/:owner/:repo/releases
17
17
18
+
Note: This returns a list of releases, which does not include regular
19
+
Git tags that have not been associated with a release.
20
+
To get a list of Git tags, use the[Repository Tags API][repo tags api].
21
+
18
22
###Response
19
23
20
24
<%= headers 200 %>
@@ -40,7 +44,7 @@ Users with push access to the repository can create a release.
40
44
41
45
###Input
42
46
43
-
Name | Type | Description
47
+
Name | Type | Description
44
48
-----|------|--------------
45
49
`tag_name`|`string` |**Required**. The name of the tag.
46
50
`target_commitish`|`string` | Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository's default branch (usually`master`).
@@ -74,7 +78,7 @@ Users with push access to the repository can edit a release.
74
78
75
79
###Input
76
80
77
-
Name | Type | Description
81
+
Name | Type | Description
78
82
-----|------|--------------
79
83
`tag_name`|`string` | The name of the tag.
80
84
`target_commitish`|`string` | Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository's default branch (usually`master`).
@@ -138,7 +142,7 @@ This endpoint is provided by a URI template in [the release's API response](#get
138
142
The raw file is uploaded to GitHub. Set the content type appropriately, and the
139
143
asset's name in a URI query parameter.
140
144
141
-
Name | Type | Description
145
+
Name | Type | Description
142
146
-----|------|--------------
143
147
`Content-Type`|`string` |**Required**. The content type of the asset. This should be set in the Header. Example: "application/zip". For a list of acceptable types, refer this list of[common media types](http://en.wikipedia.org/wiki/Internet_media_type#List_of_common_media_types).
144
148
`name`|`string` |**Required**. The file name of the asset. This should be set in the URI query parameter.
@@ -181,7 +185,7 @@ Users with push access to the repository can edit a release asset.
181
185
182
186
###Input
183
187
184
-
Name | Type | Description
188
+
Name | Type | Description
185
189
-----|------|--------------
186
190
`name`|`string` |**Required**. The file name of the asset.
187
191
`label`|`string` | An alternate short description of the asset. Used in place of the filename.