Skip to content
Try Gitea Cloud ☁️ for 30 days → Accelerate your Development & Deploys!
This is the documentation of 1.25.5, which is no longer the latest release. See the latest release.

Get a specific tag protection for the repository

GET
/repos/{owner}/{repo}/tag_protections/{id}
curl --request GET \
--url https://gitea.com/api/v1/repos/example/example/tag_protections/1 \
--header 'Authorization: Basic <credentials>'
owner
required
string

Owner of the repo

repo
required
string

Name of the repo

id
required
integer

Id of the tag protect to get

TagProtection

Media typeapplication/json

TagProtection represents a tag protection

object
created_at
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
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"
]
}

APINotFound is a not found empty response

Media typeapplication/json