Remove a userfield constraint

Last modified on September 11, 2023 at 1:53 pm

Overview

To remove a constraint from a userfield, you can send an HTTP PUT request to the userfield URL with a JSON object containing an updated constraints property, omitting the constraint you wish to remove.

When updating this property, all constraints you intend to keep must be provided. For example, if you have a userfield with minimumLength and maximumLength constraints, and you want to update only the maximumLength constraint value, you must still provide values for both minimumLength and maximumLength in the new constraints property value. If you specify only maximumLength, the constraint value for minimumLength will be cleared, leaving you with only a maximumLength constraint on the userfield.

Note that you are not limited to updating one property at a time; all fields that are valid for a particular userfield type may be updated in a single request. All fields not specified will retain their value. See the Userfield Object Reference for a list of all the object’s fields.

Example

This example shows the request-response sequence when clearing all constraints from a userfield.

Request
PUT /dc/api/v5/userfields/8da97a97a92efd18dcbc12876a4510e HTTP/1.1
Host: org.digitalchalk.com
Content-type: application/json
Accept: application/json

{
	"constraints": {}
}
Response
HTTP/1.1 204 No Content

References