Skip to content
Try Gitea Cloud ☁️ for 30 days → Accelerate your Development & Deploys!
GiteaGitea Documentation
This is the documentation of 1.24.7, which is no longer the latest release. 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
string
whitelist_teams
Array<string>
whitelist_usernames
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
string format: date-time
id
integer format: int64
name_pattern
string
updated_at
string format: date-time
whitelist_teams
Array<string>
whitelist_usernames
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

Media typeapplication/json

Headers

Section titled “Headers”
message
string
url
string

404

Section titled “404”

APINotFound is a not found empty response

Media typeapplication/json

422

Section titled “422”

APIValidationError is error format response related to input validation

Media typeapplication/json

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

Media typeapplication/json

Headers

Section titled “Headers”
message
string
url
string