---
title: "POST /v1/{+registration}:configureManagementSettings"
method: POST
path: "/v1/{+registration}:configureManagementSettings"
tags: ["projects"]
---

# POST /v1/{+registration}:configureManagementSettings

`POST /v1/{+registration}:configureManagementSettings`

Updates a `Registration`'s management settings.

## Path parameters

- `registration` string, required

## Request body

- ConfigureManagementSettingsRequest — Request for the `ConfigureManagementSettings` method.
  - `managementSettings` ManagementSettings — Defines renewal, billing, and transfer settings for a `Registration`.
    - `renewalMethod` 'RENEWAL_METHOD_UNSPECIFIED' | 'AUTOMATIC_RENEWAL' | 'MANUAL_RENEWAL' | 'RENEWAL_DISABLED' — Output only. The actual renewal method for this `Registration`. When `preferred_renewal_method` is set to `AUTOMATIC_RENEWAL`, the actual `renewal_method` can be equal to `RENEWAL_DISABLED`—for example, when there are problems with the billing account or reported domain abuse. In such cases, check the `issues` field on the `Registration`. After the problem is resolved, the `renewal_method` is automatically updated to `preferred_renewal_method` in a few hours.
    - `transferLockState` 'TRANSFER_LOCK_STATE_UNSPECIFIED' | 'UNLOCKED' | 'LOCKED' — This is the desired transfer lock state for this `Registration`. A transfer lock controls whether the domain can be transferred to another registrar. The transfer lock state of the domain is returned in the `effective_transfer_lock_state` property. The transfer lock state values might be different for the following reasons: * `transfer_lock_state` was updated only a short time ago. * Domains with the `TRANSFER_LOCK_UNSUPPORTED_BY_REGISTRY` state are in the list of `domain_properties`. These domains are always in the `UNLOCKED` state.
    - `effectiveTransferLockState` 'TRANSFER_LOCK_STATE_UNSPECIFIED' | 'UNLOCKED' | 'LOCKED' — Output only. The actual transfer lock state for this `Registration`.
    - `preferredRenewalMethod` 'RENEWAL_METHOD_UNSPECIFIED' | 'AUTOMATIC_RENEWAL' | 'MANUAL_RENEWAL' | 'RENEWAL_DISABLED' — Optional. The desired renewal method for this `Registration`. The actual `renewal_method` is automatically updated to reflect this choice. If unset or equal to `RENEWAL_METHOD_UNSPECIFIED`, the actual `renewalMethod` is treated as if it were set to `AUTOMATIC_RENEWAL`. You cannot use `RENEWAL_DISABLED` during resource creation, and you can update the renewal status only when the `Registration` resource has state `ACTIVE` or `SUSPENDED`. When `preferred_renewal_method` is set to `AUTOMATIC_RENEWAL`, the actual `renewal_method` can be set to `RENEWAL_DISABLED` in case of problems with the billing account or reported domain abuse. In such cases, check the `issues` field on the `Registration`. After the problem is resolved, the `renewal_method` is automatically updated to `preferred_renewal_method` in a few hours.
  - `updateMask` string, google-fieldmask — Required. The field mask describing which fields to update as a comma-separated list. For example, if only the transfer lock is being updated, the `update_mask` is `"transfer_lock_state"`.
  - `validateOnly` boolean — Optional. If set, validates the request without actually updating the management settings.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/domains.md) · [All operations](https://skmtc.net/google/apis/domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/domains/versions/96ed971a98da/schema)