Create a new git tag in a repository

POST

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

curl --request POST \
  --url https://gitea.example.com/api/v1/repos/example/example/tags \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "message": "example", "tag_name": "example", "target": "example" }'

Authorizations

• BasicAuth
• Token
• AccessToken
• AuthorizationHeaderToken
• SudoParam
• SudoHeader
• TOTPHeader

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

Request Body

CreateTagOption options when creating a tag

object

message

string

tag_name

required

string

target

string

Example^generated

{
  "message": "example",
  "tag_name": "example",
  "target": "example"
}

CreateTagOption options when creating a tag

object

message

string

tag_name

required

string

target

string

Responses

200

Tag

Media typeapplication/json

Tag represents a repository tag

object

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

Example^generated

{
  "commit": {
    "created": "2026-04-15T12:00:00Z",
    "sha": "example",
    "url": "example"
  },
  "id": "example",
  "message": "example",
  "name": "example",
  "tarball_url": "example",
  "zipball_url": "example"
}

404

APINotFound is a not found empty response

Media typeapplication/json

405

APIEmpty is an empty response

Media typeapplication/json

409

APIConflict is a conflict empty response

Media typeapplication/json

422

APIValidationError is error format response related to input validation

Media typeapplication/json

Headers

message

string

url

string

423

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

Media typeapplication/json

Headers

message

string

url

string