Update a container registry protection tag rule

PATCH

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

• GitLab REST API

Updates a container registry protection tag rule for a project. This feature was introduced in GitLab 18.9.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the project.

protection_rule_id

required

integer

The ID of the container protection tag rule.

Request Body

Media type application/json

object

tag_name_pattern

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

string

nullable

minimum_access_level_for_push

Minimum GitLab access level required to push container tags. For example, Maintainer, Owner, or Admin. To unset the value, use an empty string ("").

string

nullable

Allowed values: maintainer owner admin ""

minimum_access_level_for_delete

Minimum GitLab access level required to delete container tags. For example, Maintainer, Owner, or Admin. To unset the value, use an empty string ("").

string

nullable

Allowed values: maintainer owner admin ""

Responses

200

OK

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

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

Unprocessable Entity