Create

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

Creates a new tag in the project's repository.

Request

REQUIRED SCOPES

REPOSITORY_WRITE

URL PARAMETERS

workspacerequiredstring

The workspace name.

project_namerequiredstring

The name ID of the project.

POST PARAMETERS

namerequiredstring

The unique name of the tag.

commitrequiredCommit

The commit containing the revision field. The commit that needs to be tagged.

messagestring

The message of the tag.

Last modified on Jan 19, 2026

List Get

Request example


curl -X POST "https://api.buddy.works/workspaces/:workspace/projects/:project_name/repository/tags" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "v1",
  "message": "version v1",
  "commit": {
    "revision": "506a3963507943d6908154f4bc9646e829128a08"
  }
}'

Response

EXAMPLE RESPONSE
{
  "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"
}

STATUS
201 Created