Skip to content
Try Gitea Cloud ☁️ for 30 days → Accelerate your Development & Deploys!
GiteaGitea Documentation
This is the documentation of the next version, still under development. See the latest release.

Create a tag protections for a repository

POST
/repos/{owner}/{repo}/tag_protections
curl --request POST \
  --url https://gitea.com/api/v1/repos/example/example/tag_protections \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "name_pattern": "example", "whitelist_teams": [ "example" ], "whitelist_usernames": [ "example" ] }'

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”
Media typeapplication/json

CreateTagProtectionOption options for creating a tag protection

object
name_pattern

The pattern to match tag names for protection

string
whitelist_teams

List of team names allowed to create/delete protected tags

Array<string>
whitelist_usernames

List of usernames allowed to create/delete protected tags

Array<string>
Examplegenerated
{
  "name_pattern": "example",
  "whitelist_teams": [
    "example"
  ],
  "whitelist_usernames": [
    "example"
  ]
}

Responses

Section titled “Responses”

201

Section titled “201”

TagProtection

Media typeapplication/json

TagProtection represents a tag protection

object
created_at

The date and time when the tag protection was created

string format: date-time
id

The unique identifier of the tag protection

integer format: int64
name_pattern

The pattern to match tag names for protection

string
updated_at

The date and time when the tag protection was last updated

string format: date-time
whitelist_teams

List of team names allowed to create/delete protected tags

Array<string>
whitelist_usernames

List of usernames allowed to create/delete protected tags

Array<string>
Examplegenerated
{
  "created_at": "2026-04-15T12:00:00Z",
  "id": 1,
  "name_pattern": "example",
  "updated_at": "2026-04-15T12:00:00Z",
  "whitelist_teams": [
    "example"
  ],
  "whitelist_usernames": [
    "example"
  ]
}

403

Section titled “403”

APIForbiddenError is a forbidden error response

Headers

Section titled “Headers”
message
string
url
string

404

Section titled “404”

APINotFound is a not found empty response

422

Section titled “422”

APIValidationError is error format response related to input validation

Headers

Section titled “Headers”
message
string
url
string

423

Section titled “423”

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

Headers

Section titled “Headers”
message
string
url
string