Protect a repository tag

POST

/api/v4/projects/{id}/protected_tags

• GitLab REST API

Protects a specified repository tag using a wildcard protected tag.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the project

Request Body ^required

Media type application/json

object

name

required

The name of the protected tag

string

nullable

Example

release-1-0

create_access_level

Access levels allowed to create (defaults: 40, maintainer access level)

integer

nullable

Allowed values: 30 40 60 0

allowed_to_create

Array of users, groups, deploy keys, or access levels allowed to create protected branches

Array<object>

nullable

object

Responses

201

Created

Media type application/json

object

name

string

create_access_levels

Array<object>

object

id

integer format: int64

access_level

integer

access_level_description

string

deploy_key_id

integer format: int64

user_id

integer format: int64

group_id

integer format: int64

member_role_id

integer format: int64

member_role_name

string

Example

{
  "name": "release-1-0",
  "create_access_levels": [
    {
      "id": 1,
      "access_level": 40,
      "access_level_description": "Maintainers",
      "deploy_key_id": 1,
      "user_id": 1,
      "group_id": 1,
      "member_role_id": 42,
      "member_role_name": "Lead Developer"
    }
  ]
}

400

Bad Request

403

Unauthenticated

404

Not found

422

Unprocessable entity