NextGen APIs

PATCH /documents/dynamic-forms/r1/templates/{templateId}/working-copies/global-expressions

Http Verb

PATCH

Url

/documents/dynamic-forms/r1/templates/{templateId}/working-copies/global-expressions

Permissions required


Personally Identifiable Information (PII)

No

Sensitive Information

No

Last Modified Version

r1

Released since

2026 W1 (FSM 22.0)

Deprecated since


Removed since


Tech Tags

​ ​

Business Logic

This API updates the global expressions associated with the working copy of the dynamic form template.

Global expressions are cross-node validation rules that can reference multiple nodes in the template and generate warnings or errors when evaluated.

Returns HTTP 204 No Content on successful update.

Path Parameters

Field

Note

templateId

The unique identifier of the dynamic form template

Header Parameters

Default.

Request Body Parameters

Array of global expression objects.

Field

Notes

id

Long - Unique identifier of the global expression (optional for new expressions)

name

String - Name of the global expression (required)

expression

String - Expression string using node references (e.g., #{endDate.value} > #{startDate.value}) (required)

message

LocalizedString - Localized message to display when the expression fails (required)

type

String - Type of expression: WARNING or ERROR (required)

Request Body Example

JSON
[
  {
    "id": 1,
    "name": "dateRangeValidation",
    "expression": "#{endDate.value} > #{startDate.value}",
    "message": {
      "en": "End date must be after start date",
      "it": "La data di fine deve essere successiva alla data di inizio"
    },
    "type": "ERROR"
  },
  {
    "id": 2,
    "name": "quantityWarning",
    "expression": "#{quantity.value} > 100",
    "message": {
      "en": "Quantity exceeds recommended limit",
      "it": "La quantità supera il limite consigliato"
    },
    "type": "WARNING"
  }
]

Response documentation

Response error codes

NOT_FOUND, BASE_0001, BASE_0006, BASE_0007, BASE_0010