Update a Terraform state protection rule for a project

PATCH

/api/v4/projects/{id}/terraform/state_protection_rules/{terraform_state_protection_rule_id}

• GitLab REST API

This feature was introduced in GitLab 19.0.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the project

terraform_state_protection_rule_id

required

integer

The ID of the Terraform state protection rule

Request Body

Media typeapplication/json

object

state_name

Terraform state name to protect.

string

nullable

minimum_access_level_for_write

If defined, sets the minimum GitLab access level required to write to the Terraform state.

string

nullable

Allowed values: developer maintainer owner admin

allowed_from

If defined, write requests must be made from the specific source.

string

nullable

Allowed values: anywhere ci_only ci_on_protected_branch_only

Responses

200

OK

Media typeapplication/json

object

id

integer format: int64

project_id

integer format: int64

state_name

string

minimum_access_level_for_write

string

allowed_from

string

Example

{
  "id": 1,
  "project_id": 1,
  "state_name": "production",
  "minimum_access_level_for_write": "maintainer",
  "allowed_from": "ci_only"
}

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

Unprocessable Entity