Get a list of repository tags from a project, sorted by name in reverse alphabetical order.
GET /projects/:id/repository/tagsParameters:
id (required) - The ID of a project[
{
"commit": {
"author_name": "John Smith",
"author_email": "[email protected]",
"authored_date": "2012-05-28T04:42:42-07:00",
"committed_date": "2012-05-28T04:42:42-07:00",
"committer_name": "Jack Smith",
"committer_email": "[email protected]",
"id": "2695effb5807a22ff3d138d593fd856244e155e7",
"message": "Initial commit",
"parents_ids": [
"2a4b78934375d7f53875269ffd4f45fd83a84ebe"
]
},
"release": {
"tag_name": "1.0.0",
"description": "Amazing release. Wow"
},
"name": "v1.0.0",
"message": null
}
]Get a specific repository tag determined by its name. It returns 200 together with the tag information if the tag exists. It returns 404 if the tag does not exist.
GET /projects/:id/repository/tags/:tag_nameParameters:
| Attribute | Type | Required | Description |
|---|---|---|---|
id |
integer | yes | The ID of a project |
tag_name |
string | yes | The name of the tag |
curl -H "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitswarm.example.com/api/v3/projects/5/repository/tags/v1.0.0Example Response:
{
"name": "v5.0.0",
"message": null,
"commit": {
"id": "60a8ff033665e1207714d6670fcd7b65304ec02f",
"message": "v5.0.0\n",
"parent_ids": [
"f61c062ff8bcbdb00e0a1b3317a91aed6ceee06b"
],
"authored_date": "2015-02-01T21:56:31.000+01:00",
"author_name": "Arthur Verschaeve",
"author_email": "[email protected]",
"committed_date": "2015-02-01T21:56:31.000+01:00",
"committer_name": "Arthur Verschaeve",
"committer_email": "[email protected]"
},
"release": null
}Creates a new tag in the repository that points to the supplied ref.
POST /projects/:id/repository/tagsParameters:
id (required) - The ID of a projecttag_name (required) - The name of a tagref (required) - Create tag using commit SHA, another tag name, or branch name.message (optional) - Creates annotated tag.release_description (optional) - Add release notes to the git tag and store it in the GitSwarm database.{
"commit": {
"author_name": "John Smith",
"author_email": "[email protected]",
"authored_date": "2012-05-28T04:42:42-07:00",
"committed_date": "2012-05-28T04:42:42-07:00",
"committer_name": "Jack Smith",
"committer_email": "[email protected]",
"id": "2695effb5807a22ff3d138d593fd856244e155e7",
"message": "Initial commit",
"parents_ids": [
"2a4b78934375d7f53875269ffd4f45fd83a84ebe"
]
},
"release": {
"tag_name": "1.0.0",
"description": "Amazing release. Wow"
},
"name": "v1.0.0",
"message": null
}The message will be nil when creating a lightweight tag otherwise it will contain the annotation.
It returns 200 if the operation succeed. In case of an error, 405 with an explaining error message is returned.
Deletes a tag of a repository with given name. On success, this API method returns 200 with the name of the deleted tag. If the tag does not exist, the API returns 404.
DELETE /projects/:id/repository/tags/:tag_nameParameters:
id (required) - The ID of a projecttag_name (required) - The name of a tag{
"tag_name": "v4.3.0"
}Add release notes to the existing git tag. It returns 201 if the release is created successfully. If the tag does not exist, 404 is returned. If there already exists a release for the given tag, 409 is returned.
POST /projects/:id/repository/tags/:tag_name/releaseParameters:
id (required) - The ID of a projecttag_name (required) - The name of a tagdescription (required) - Release notes with markdown support{
"tag_name": "1.0.0",
"description": "Amazing release. Wow"
}Updates the release notes of a given release. It returns 200 if the release is successfully updated. If the tag or the release does not exist, it returns 404 with a proper error message.
PUT /projects/:id/repository/tags/:tag_name/releaseParameters:
id (required) - The ID of a projecttag_name (required) - The name of a tagdescription (required) - Release notes with markdown support{
"tag_name": "1.0.0",
"description": "Amazing release. Wow"
}