List tag protections for a repository

GET

/repos/{owner}/{repo}/tag_protections

curl --request GET \
  --url https://gitea.com/api/v1/repos/example/example/tag_protections \
  --header 'Authorization: Basic <credentials>'

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

Responses

200

TagProtectionList

Media typeapplication/json

Array<object>

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>

Example^generated

[
  {
    "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"
    ]
  }
]