Create

Creates a new tag in the project's repository.

Required scopes: WORKSPACE, REPOSITORY_WRITE

Resource URL

POST /workspaces/:domain/projects/:project_name/repository/tags

URL Parameters

NameTypeDescription
domain
Required
StringThe workspace domain.
project_name
Required
StringThe name ID of the project.

POST Parameters

NameTypeDescription
name
Required
StringThe unique name of the tag.
commmit
Required
CommitThe commit containing the revision field. The commit that needs to be tagged.
messageStringThe message of the tag.

Request

POST https://api.buddy.works/workspaces/buddy/projects/company-website/repository/tags

JSON

{

  "name": "v1",
  "message": "version v1",
  "commit": {
    "revision": "506a3963507943d6908154f4bc9646e829128a08"
  }
}

Sample Response

HTTP

Status: 201 Created
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999

JSON

{
  "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/repository/tags/v1",
  "html_url": "https://app.buddy.works/buddy/company-website/repository/tags/v1",
  "name": "v1",
  "commit": {
    "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/repository/commits/506a3963507943d6908154f4bc9646e829128a08",
    "html_url": "https://app.buddy.works/buddy/company-website/repository/commit/506a3963507943d6908154f4bc9646e829128a08",
    "revision": "506a3963507943d6908154f4bc9646e829128a08",
    "author_date": "2016-01-19T12:36:33Z",
    "commit_date": "2016-01-19T12:36:33Z",
    "message": "init repo\n",
    "committer": {
      "url": "https://api.buddy.works/workspaces/buddy/member/1",
      "html_url": "https://app.buddy.works/buddy/profile/1",
      "id": 1,
      "name": "Mike Benson",
      "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png"
    },
    "author": {
      "url": "https://api.buddy.works/workspaces/buddy/member/1",
      "html_url": "https://app.buddy.works/buddy/profile/1",
      "id": 1,
      "name": "Mike Benson",
      "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png"
    }
  },
  "message": "version v1"
}

Get Started

Sign up for free and deploy your project in less than 10 minutes.