Skip to content
forgit api docs

Create a new git tag in a repository

POST
/repos/{owner}/{repo}/tags

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
owner
required
string

Owner of the repo

repo
required
string

Name of the repo

Request Body

Section titled “Request Body”

CreateTagOption options when creating a tag

object
message
string
tag_name
required
string
target
string
Examplegenerated
{
  "message": "example",
  "tag_name": "example",
  "target": "example"
}

Responses

Section titled “Responses”

201

Section titled “201”

Tag

Media typeapplication/json

Tag represents a repository tag

object
archive_download_count

TagArchiveDownloadCount counts how many times a archive was downloaded

object
tar_gz
integer format: int64
zip
integer format: int64
commit
CommitMeta contains meta information of a commit in terms of API.
object
created
string format: date-time
sha
string
url
string
id
string
message
string
name
string
tarball_url
string
zipball_url
string
Examplegenerated
{
  "archive_download_count": {
    "tar_gz": 1,
    "zip": 1
  },
  "commit": {
    "created": "2026-04-15T12:00:00Z",
    "sha": "example",
    "url": "example"
  },
  "id": "example",
  "message": "example",
  "name": "example",
  "tarball_url": "example",
  "zipball_url": "example"
}

404

Section titled “404”

APINotFound is a not found error response

Media typeapplication/json
object
errors
Array<string>
message
string
url
string
Examplegenerated
{
  "errors": [
    "example"
  ],
  "message": "example",
  "url": "example"
}

405

Section titled “405”

APIEmpty is an empty response

Media typeapplication/json

409

Section titled “409”

APIConflict is a conflict empty response

Media typeapplication/json

413

Section titled “413”

QuotaExceeded

Media typeapplication/json

Headers

Section titled “Headers”
message
string
user_id
integer format: int64
username
string

422

Section titled “422”

APIValidationError is error format response related to input validation

Media typeapplication/json
object
message
string
url
string
Examplegenerated
{
  "message": "example",
  "url": "example"
}

423

Section titled “423”

APIRepoArchivedError is an error that is raised when an archived repo should be modified

Media typeapplication/json
object
message
string
url
string
Examplegenerated
{
  "message": "example",
  "url": "example"
}