Skip to content
forgit api docs

Create a container registry protection tag rule

POST
/api/v4/projects/{id}/registry/protection/tag/rules

Creates a container registry protection tag rule for a project to control who can push or delete container tags. This feature was introduced in GitLab 18.8.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
One of:
string

The ID or URL-encoded path of the project.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
tag_name_pattern
required

Container tag name pattern protected by the protection rule. For example, v*-release. Wildcard character * allowed.

string
nullable
minimum_access_level_for_push
required

Minimum GitLab access level required to push container tags. For example, Maintainer, Owner, or Admin.

string
>= 1 characters
Allowed values: maintainer owner admin
minimum_access_level_for_delete
required

Minimum GitLab access level required to delete container tags. For example, Maintainer, Owner, or Admin.

string
>= 1 characters
Allowed values: maintainer owner admin

Responses

Section titled “Responses”

201

Section titled “201”

Created

Media typeapplication/json
object
id
integer format: int64
project_id
integer format: int64
tag_name_pattern
string
minimum_access_level_for_push
string
minimum_access_level_for_delete
string
Example
{
  "id": 1,
  "project_id": 123,
  "tag_name_pattern": "v*-release",
  "minimum_access_level_for_push": "maintainer",
  "minimum_access_level_for_delete": "maintainer"
}

400

Section titled “400”

Bad Request

401

Section titled “401”

Unauthorized

403

Section titled “403”

Forbidden

404

Section titled “404”

Not Found

422

Section titled “422”

Unprocessable Entity