GitSwarm 2016.3-2 Documentation


Tags

List project repository tags

Get a list of repository tags from a project, sorted by name in reverse alphabetical order.

GET /projects/:id/repository/tags

Parameters:

[
  {
    "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 single repository tag

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_name

Parameters:

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.0

Example 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
}

Create a new tag

Creates a new tag in the repository that points to the supplied ref.

POST /projects/:id/repository/tags

Parameters:

{
  "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.

Delete a tag

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_name

Parameters:

{
  "tag_name": "v4.3.0"
}

Create a new release

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/release

Parameters:

{
  "tag_name": "1.0.0",
  "description": "Amazing release. Wow"
}

Update a release

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/release

Parameters:

{
  "tag_name": "1.0.0",
  "description": "Amazing release. Wow"
}