Create a tag protections for a repository

POST

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

Authorizations

• BasicAuth
• AuthorizationHeaderToken
• SudoParam
• SudoHeader
• TOTPHeader

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

Request Body

Media type application/json

CreateTagProtectionOption options for creating a tag protection

object

name_pattern

string

whitelist_teams

Array<string>

whitelist_usernames

Array<string>

Example ^generated

{
  "name_pattern": "example",
  "whitelist_teams": [
    "example"
  ],
  "whitelist_usernames": [
    "example"
  ]
}

Responses

201

TagProtection

Media type application/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>

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

403

APIForbiddenError is a forbidden error response

Media type application/json

object

message

string

url

string

Example ^generated

{
  "message": "example",
  "url": "example"
}

404

APINotFound is a not found error response

Media type application/json

object

errors

Array<string>

message

string

url

string

Example ^generated

{
  "errors": [
    "example"
  ],
  "message": "example",
  "url": "example"
}

422

APIValidationError is error format response related to input validation

Media type application/json

object

message

string

url

string

Example ^generated

{
  "message": "example",
  "url": "example"
}

423

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

Media type application/json

object

message

string

url

string

Example ^generated

{
  "message": "example",
  "url": "example"
}