1. REST API for Clinical One Cloud Service
  2. Tasks
  3. Rule Designer
  4. Rule Management
  5. Update rules in bulk

[Deprecated]: v1.0
put

/ec-rule-designer-svc/rest/v1.0/rule/studies/{studyId}/{mode}/bulkupdate

Deprecated: Use latest version instead. Updates multiple rules within a study in a single transaction. Each rule entry must specify operands, actions, and the desired enabled state. Requests are validated against the supplied study mode (design or test) before any persistence changes are committed. Version 1.0 relies on the legacy synchronous engine and does not provide the performance optimizations or job identifier tracking added in versions 6.0 and 7.0.

Request

Path Parameters
  • Study mode determines the data segment being managed. Allowed values: design (draft configuration workspace), test (UAT sandbox), training (sandbox for practice data), production (live subject data).
    Example:
    test
  • Unique study identifier supplied as a UUID. Accepts either a compact 32-character hexadecimal value or a hyphenated 36-character UUID.
    Example:
    36753A48BBA048CB98A5F3278146118D
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Payload containing the rules to be updated in a single bulk request.
Show Source
Nested Schema : rules
Type: array
List of rule definitions to update in a single request.
Show Source
Example:
[
    {
        "ruleId":"82A65F8F6AAF47FFB177662E3931E7C0",
        "ruleRefName":"VISIT_DATE_WINDOW",
        "ruleExpression":"return visitDate >= baselineDate;",
        "ruleJSExpression":"return visitDate >= baselineDate;",
        "studyVersion":"26.2.0.0",
        "ruleEnabled":1,
        "ruleDeleted":0,
        "ruleVersionNumber":101,
        "ruleDescription":"Blocks visits dated before the baseline date.",
        "ruleName":"Visit Date Validation",
        "ruleState":"draft",
        "ruleValidationStatus":"true",
        "ruleValidationMessage":"Validated on 2026-03-30.",
        "ruleOriginType":"user rule",
        "actions":[
            {
                "eventId":"9B4AA96F48344015A259D6436EB97B47",
                "eventRefName":"SCREENING",
                "formId":"39903D6C042D4D9E89773160488E6D3D",
                "formRefName":"VISIT_START",
                "itemId":"2F4F4E67E0CE4BE0BB9544D2CD38A569",
                "itemRefName":"VISIT_DATE",
                "ruleActionTypeName":"auto query",
                "ruleActionOrder":1,
                "ruleActionDescription":"Raise a query when visit date is invalid.",
                "ruleActionParams":"queryMessage=Confirm visit date"
            }
        ],
        "operands":[
            {
                "eventId":"9B4AA96F48344015A259D6436EB97B47",
                "eventRefName":"SCREENING",
                "eventInstanceNumber":0,
                "formId":"39903D6C042D4D9E89773160488E6D3D",
                "formRefName":"VISIT_START",
                "itemId":"2F4F4E67E0CE4BE0BB9544D2CD38A569",
                "itemRefName":"VISIT_DATE",
                "propertyType":"visit",
                "propertyName":"visitStartDate",
                "operandName":"visitDate",
                "dataType":"Date"
            }
        ]
    }
]
Nested Schema : UpdateRuleDTO
Type: object
Title: UpdateRuleDTO
Information for Updating rule
Show Source
  • actions
    Ordered list of actions executed when the rule evaluates to true.
  • operands
    Operands referenced within the rule expression.
  • Minimum Value: 0
    Maximum Value: 1
    Soft delete flag. Use 1 to mark the rule as deleted or 0 to keep it active. Negative values are not permitted.
    Example: 0
  • Minimum Length: 1
    Maximum Length: 1024
    Detailed description of the rule purpose.
    Example: Blocks visits dated before the baseline date.
  • Minimum Value: 0
    Maximum Value: 1
    Rule enabled flag. Use 1 to enable the rule or 0 to keep it disabled. Negative values are not permitted.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Readable expression that defines the rule logic.
    Example: return visitDate >= baselineDate;
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-Fa-f]{32}$
    Unique identifier of the rule being updated. Provide a 32-character hexadecimal value without separators.
  • Minimum Length: 1
    Maximum Length: 4000
    JavaScript representation of the rule. Retain existing value when editing.
    Example: return visitDate >= baselineDate;
  • Minimum Length: 3
    Maximum Length: 256
    Display name for the rule shown in the user interface.
    Example: Visit Date Validation
  • Minimum Length: 6
    Maximum Length: 32
    Allowed Values: [ "user rule", "smart object age", "ui_notification" ]
    Channel that originally created the rule. Allowed values: `user rule`, `smart object age`, or `ui_notification`.
    Example: user rule
  • Minimum Length: 3
    Maximum Length: 128
    Pattern: ^[A-Za-z0-9_]+$
    Internal reference name for the rule. Use alphanumeric characters and underscores without spaces.
    Example: VISIT_DATE_WINDOW
  • Minimum Length: 4
    Maximum Length: 8
    Allowed Values: [ "draft", "uat", "approved", "publish" ]
    Lifecycle state of the rule.
    Example: draft
  • Minimum Length: 1
    Maximum Length: 512
    Message produced by the last validation attempt.
    Example: Validated on 2026-03-30.
  • Minimum Length: 4
    Maximum Length: 5
    Allowed Values: [ "true", "false" ]
    Result of the last validation event. Provide `true` when validation succeeded or `false` otherwise.
    Example: true
  • Minimum Value: 0
    Maximum Value: 9999
    Sequential rule version number. Provide a non-negative integer.
    Example: 100
  • Minimum Length: 1
    Maximum Length: 32
    Study version associated with the rule.
    Example: 26.2.0.0
Example:
{
    "ruleId":"82A65F8F6AAF47FFB177662E3931E7C0",
    "ruleRefName":"VISIT_DATE_WINDOW",
    "ruleExpression":"return visitDate >= baselineDate;",
    "studyVersion":"26.2.0.0",
    "ruleEnabled":1,
    "ruleDeleted":0,
    "ruleVersionNumber":101,
    "ruleName":"Visit Date Validation"
}
Nested Schema : actions
Type: array
Ordered list of actions executed when the rule evaluates to true.
Show Source
Example:
[
    {
        "eventId":"9B4AA96F48344015A259D6436EB97B47",
        "formId":"39903D6C042D4D9E89773160488E6D3D",
        "itemId":"2F4F4E67E0CE4BE0BB9544D2CD38A569",
        "ruleActionTypeName":"auto query",
        "ruleActionOrder":1
    }
]
Nested Schema : operands
Type: array
Operands referenced within the rule expression.
Show Source
Example:
[
    {
        "eventId":"9B4AA96F48344015A259D6436EB97B47",
        "formId":"39903D6C042D4D9E89773160488E6D3D",
        "itemId":"2F4F4E67E0CE4BE0BB9544D2CD38A569",
        "operandName":"visitDate",
        "dataType":"Date"
    }
]
Nested Schema : RuleActionDTO
Type: object
Title: RuleActionDTO
Information about action for rule
Show Source
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-Fa-f]{32}$
    Identifier of the visit/event that hosts the action.
  • Minimum Length: 1
    Maximum Length: 64
    Reference name for the visit/event.
    Example: SCREENING
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-Fa-f]{32}$
    Identifier of the form impacted by the action.
  • Minimum Length: 1
    Maximum Length: 64
    Reference name for the form.
    Example: VISIT_START
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-Fa-f]{32}$
    Identifier of the item updated or queried by the action.
  • Minimum Length: 1
    Maximum Length: 64
    Reference name for the item.
    Example: VISIT_DATE
  • Minimum Length: 1
    Maximum Length: 512
    Optional description that explains the action to administrators.
    Example: Raise a query when visit date is invalid.
  • Minimum Value: 0
    Maximum Value: 9999
    Sequence in which this action should execute after the rule triggers. Provide a non-negative integer.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 1024
    Optional key/value parameters applied to the action.
    Example: queryMessage=Confirm visit date
  • Minimum Length: 6
    Maximum Length: 21
    Allowed Values: [ "calculated values", "auto query", "assigned query", "generic calculations", "notification" ]
    Type of action executed when the rule fires. Allowed values: `calculated values`, `auto query`, `assigned query`, `generic calculations`, or `notification`.
    Example: auto query
Example:
{
    "eventId":"9B4AA96F48344015A259D6436EB97B47",
    "eventRefName":"SCREENING",
    "formId":"39903D6C042D4D9E89773160488E6D3D",
    "formRefName":"VISIT_START",
    "itemId":"2F4F4E67E0CE4BE0BB9544D2CD38A569",
    "itemRefName":"VISIT_DATE",
    "ruleActionTypeName":"auto query",
    "ruleActionOrder":0,
    "ruleActionDescription":"Raise a query when visit date is missing.",
    "ruleActionParams":"queryMessage=Confirm visit date"
}
Nested Schema : RuleOperandDTO
Type: object
Title: RuleOperandDTO
Information about operands for rule
Show Source
  • Minimum Value: 0
    Maximum Value: 999
    Sequence number of the repeating event instance. Provide a non-negative integer; omit when not applicable.
    Example: 0
  • Minimum Length: 4
    Maximum Length: 7
    Allowed Values: [ "Date", "Number", "Boolean", "Text", "Choice" ]
    Data type of the operand value. Allowed values: `Date`, `Number`, `Boolean`, `Text`, or `Choice`.
    Example: Date
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-Fa-f]{32}$
    Identifier of the visit/event providing operand context.
  • Minimum Length: 1
    Maximum Length: 64
    Reference name for the visit/event supplying the operand.
    Example: SCREENING
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-Fa-f]{32}$
    Identifier of the form that supplies the operand value.
  • Minimum Length: 1
    Maximum Length: 64
    Reference name for the form that hosts the operand.
    Example: VISIT_START
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-Fa-f]{32}$
    Identifier of the item referenced by the operand.
  • Minimum Length: 1
    Maximum Length: 64
    Reference name for the item.
    Example: VISIT_DATE
  • Minimum Length: 1
    Maximum Length: 128
    Name of the operand as referenced in the rule expression.
    Example: visitDate
  • Minimum Length: 1
    Maximum Length: 128
    Name of the study object property targeted by the operand.
    Example: visitStartDate
  • Minimum Length: 5
    Maximum Length: 5
    Allowed Values: [ "visit" ]
    Type of study object property mapped to the operand. Allowed value: `visit`.
    Example: visit
Example:
{
    "eventId":"9B4AA96F48344015A259D6436EB97B47",
    "eventRefName":"SCREENING",
    "eventInstanceNumber":0,
    "formId":"39903D6C042D4D9E89773160488E6D3D",
    "formRefName":"VISIT_START",
    "itemId":"2F4F4E67E0CE4BE0BB9544D2CD38A569",
    "itemRefName":"VISIT_DATE",
    "propertyType":"visit",
    "propertyName":"visitStartDate",
    "operandName":"visitDate",
    "dataType":"Date"
}
Examples

Back to Top

Response

Supported Media Types

200 Response

Bulk rule update was successful.
Body ()
Root Schema : RDSRestUnifiedResponseDTO
Type: object
Unified response entry returned when bulk operations process multiple rules.
Show Source
  • RDSRestErrorDataDTO
    Standard error structure returned by Rule Designer APIs.
  • Minimum Value: 100
    Maximum Value: 599
    HTTP status code representing the operation result for this rule.
    Example: 200
  • Minimum Length: 2
    Maximum Length: 64
    Status text associated with the HTTP code.
    Example: Success
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-F]{32}$
    Identifier of the asynchronous job triggered by the bulk action. Represented as a 32 character uppercase hexadecimal string without separators.
    Example: 123E4567E89B12D3A456426655440001
  • Minimum Length: 4
    Maximum Length: 16
    Allowed Values: [ "Success", "Failed", "Error", "InProgress", "Queued" ]
    Execution state of the job for this rule. `Success` indicates completion, `Failed` signals a validation problem, `Error` represents an unexpected exception, `InProgress` denotes active processing, and `Queued` means the job awaits execution.
    Example: Success
  • RDSRestResponseDTO
    Response from Rule Designer APIs
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-F]{32}$
    Identifier of the rule that was processed. The value is provided as a 32 character uppercase hexadecimal string without separators.
    Example: 8E2253D8E53A4A46BAE3E4952CBE9E5A
  • Minimum Length: 3
    Maximum Length: 256
    Display name of the rule.
    Example: Out of Range Visit Date
  • Minimum Length: 1
    Maximum Length: 512
    Validation outcome message generated while processing the rule.
    Example: Rule updated successfully.
  • Allowed Values: [ true, false ]
    `true` indicates that validation succeeded for the rule, while `false` captures warnings or errors.
    Example: true
Nested Schema : RDSRestErrorDataDTO
Type: object
Standard error structure returned by Rule Designer APIs.
Show Source
  • details
    Read Only: true
    Optional diagnostic information when available.
  • Read Only: true
    Minimum Length: 3
    Maximum Length: 64
    Application specific error identifier.
    Example: RuleSvc-030
  • Read Only: true
    Minimum Length: 10
    Maximum Length: 512
    Human-readable summary explaining the error.
    Example: Error encountered during rule execution. Contact your system administrator.
  • Read Only: true
    Minimum Length: 4
    Maximum Length: 4
    Successful payload content when available; remains null for error responses.
    Example: null
  • Read Only: true
    Minimum Length: 6
    Maximum Length: 6
    Allowed Values: [ "failed" ]
    Overall outcome indicator. `failed` means the request could not be fulfilled.
    Example: failed
Example:
{
    "status":"failed",
    "result":null,
    "errorCode":"RuleSvc-030",
    "errorMessage":"Error encountered during rule execution.",
    "details":null
}
Nested Schema : RDSRestResponseDTO
Type: object
Response from Rule Designer APIs
Show Source
  • result
    Read Only: true
    Maximum Number of Properties: 2000
    Result payload when the request succeeds. Structure depends on the endpoint.
  • Read Only: true
    Minimum Length: 6
    Maximum Length: 7
    Allowed Values: [ "success", "failed" ]
    Overall outcome for the call. Allowed values: success, failed.
    Example: success
Example:
{
    "status":"success",
    "result":{
        "message":"Rule updated successfully."
    }
}
Nested Schema : details
Type: object
Read Only: true
Optional diagnostic information when available.
Example:
Validation failed for ruleId 8E2253D8E53A4A46BAE3E4952CBE9E5A.
Nested Schema : result
Type: object
Read Only: true
Maximum Number of Properties: 2000
Result payload when the request succeeds. Structure depends on the endpoint.
Example:
{
    "rules":[
    ]
}
Examples

400 Response

Returned when the request payload is missing required fields, supplies invalid identifiers, or otherwise fails validation.
Body ()
Root Schema : RDSRestUnifiedResponseDTO
Type: object
Unified response entry returned when bulk operations process multiple rules.
Show Source
  • RDSRestErrorDataDTO
    Standard error structure returned by Rule Designer APIs.
  • Minimum Value: 100
    Maximum Value: 599
    HTTP status code representing the operation result for this rule.
    Example: 200
  • Minimum Length: 2
    Maximum Length: 64
    Status text associated with the HTTP code.
    Example: Success
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-F]{32}$
    Identifier of the asynchronous job triggered by the bulk action. Represented as a 32 character uppercase hexadecimal string without separators.
    Example: 123E4567E89B12D3A456426655440001
  • Minimum Length: 4
    Maximum Length: 16
    Allowed Values: [ "Success", "Failed", "Error", "InProgress", "Queued" ]
    Execution state of the job for this rule. `Success` indicates completion, `Failed` signals a validation problem, `Error` represents an unexpected exception, `InProgress` denotes active processing, and `Queued` means the job awaits execution.
    Example: Success
  • RDSRestResponseDTO
    Response from Rule Designer APIs
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-F]{32}$
    Identifier of the rule that was processed. The value is provided as a 32 character uppercase hexadecimal string without separators.
    Example: 8E2253D8E53A4A46BAE3E4952CBE9E5A
  • Minimum Length: 3
    Maximum Length: 256
    Display name of the rule.
    Example: Out of Range Visit Date
  • Minimum Length: 1
    Maximum Length: 512
    Validation outcome message generated while processing the rule.
    Example: Rule updated successfully.
  • Allowed Values: [ true, false ]
    `true` indicates that validation succeeded for the rule, while `false` captures warnings or errors.
    Example: true
Nested Schema : RDSRestErrorDataDTO
Type: object
Standard error structure returned by Rule Designer APIs.
Show Source
  • details
    Read Only: true
    Optional diagnostic information when available.
  • Read Only: true
    Minimum Length: 3
    Maximum Length: 64
    Application specific error identifier.
    Example: RuleSvc-030
  • Read Only: true
    Minimum Length: 10
    Maximum Length: 512
    Human-readable summary explaining the error.
    Example: Error encountered during rule execution. Contact your system administrator.
  • Read Only: true
    Minimum Length: 4
    Maximum Length: 4
    Successful payload content when available; remains null for error responses.
    Example: null
  • Read Only: true
    Minimum Length: 6
    Maximum Length: 6
    Allowed Values: [ "failed" ]
    Overall outcome indicator. `failed` means the request could not be fulfilled.
    Example: failed
Example:
{
    "status":"failed",
    "result":null,
    "errorCode":"RuleSvc-030",
    "errorMessage":"Error encountered during rule execution.",
    "details":null
}
Nested Schema : RDSRestResponseDTO
Type: object
Response from Rule Designer APIs
Show Source
  • result
    Read Only: true
    Maximum Number of Properties: 2000
    Result payload when the request succeeds. Structure depends on the endpoint.
  • Read Only: true
    Minimum Length: 6
    Maximum Length: 7
    Allowed Values: [ "success", "failed" ]
    Overall outcome for the call. Allowed values: success, failed.
    Example: success
Example:
{
    "status":"success",
    "result":{
        "message":"Rule updated successfully."
    }
}
Nested Schema : details
Type: object
Read Only: true
Optional diagnostic information when available.
Example:
Validation failed for ruleId 8E2253D8E53A4A46BAE3E4952CBE9E5A.
Nested Schema : result
Type: object
Read Only: true
Maximum Number of Properties: 2000
Result payload when the request succeeds. Structure depends on the endpoint.
Example:
{
    "rules":[
    ]
}
Examples

500 Response

Returned when the service encounters an unexpected server-side error while processing the request.
Body ()
Root Schema : RDSRestUnifiedResponseDTO
Type: object
Unified response entry returned when bulk operations process multiple rules.
Show Source
  • RDSRestErrorDataDTO
    Standard error structure returned by Rule Designer APIs.
  • Minimum Value: 100
    Maximum Value: 599
    HTTP status code representing the operation result for this rule.
    Example: 200
  • Minimum Length: 2
    Maximum Length: 64
    Status text associated with the HTTP code.
    Example: Success
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-F]{32}$
    Identifier of the asynchronous job triggered by the bulk action. Represented as a 32 character uppercase hexadecimal string without separators.
    Example: 123E4567E89B12D3A456426655440001
  • Minimum Length: 4
    Maximum Length: 16
    Allowed Values: [ "Success", "Failed", "Error", "InProgress", "Queued" ]
    Execution state of the job for this rule. `Success` indicates completion, `Failed` signals a validation problem, `Error` represents an unexpected exception, `InProgress` denotes active processing, and `Queued` means the job awaits execution.
    Example: Success
  • RDSRestResponseDTO
    Response from Rule Designer APIs
  • Minimum Length: 32
    Maximum Length: 32
    Pattern: ^[0-9A-F]{32}$
    Identifier of the rule that was processed. The value is provided as a 32 character uppercase hexadecimal string without separators.
    Example: 8E2253D8E53A4A46BAE3E4952CBE9E5A
  • Minimum Length: 3
    Maximum Length: 256
    Display name of the rule.
    Example: Out of Range Visit Date
  • Minimum Length: 1
    Maximum Length: 512
    Validation outcome message generated while processing the rule.
    Example: Rule updated successfully.
  • Allowed Values: [ true, false ]
    `true` indicates that validation succeeded for the rule, while `false` captures warnings or errors.
    Example: true
Nested Schema : RDSRestErrorDataDTO
Type: object
Standard error structure returned by Rule Designer APIs.
Show Source
  • details
    Read Only: true
    Optional diagnostic information when available.
  • Read Only: true
    Minimum Length: 3
    Maximum Length: 64
    Application specific error identifier.
    Example: RuleSvc-030
  • Read Only: true
    Minimum Length: 10
    Maximum Length: 512
    Human-readable summary explaining the error.
    Example: Error encountered during rule execution. Contact your system administrator.
  • Read Only: true
    Minimum Length: 4
    Maximum Length: 4
    Successful payload content when available; remains null for error responses.
    Example: null
  • Read Only: true
    Minimum Length: 6
    Maximum Length: 6
    Allowed Values: [ "failed" ]
    Overall outcome indicator. `failed` means the request could not be fulfilled.
    Example: failed
Example:
{
    "status":"failed",
    "result":null,
    "errorCode":"RuleSvc-030",
    "errorMessage":"Error encountered during rule execution.",
    "details":null
}
Nested Schema : RDSRestResponseDTO
Type: object
Response from Rule Designer APIs
Show Source
  • result
    Read Only: true
    Maximum Number of Properties: 2000
    Result payload when the request succeeds. Structure depends on the endpoint.
  • Read Only: true
    Minimum Length: 6
    Maximum Length: 7
    Allowed Values: [ "success", "failed" ]
    Overall outcome for the call. Allowed values: success, failed.
    Example: success
Example:
{
    "status":"success",
    "result":{
        "message":"Rule updated successfully."
    }
}
Nested Schema : details
Type: object
Read Only: true
Optional diagnostic information when available.
Example:
Validation failed for ruleId 8E2253D8E53A4A46BAE3E4952CBE9E5A.
Nested Schema : result
Type: object
Read Only: true
Maximum Number of Properties: 2000
Result payload when the request succeeds. Structure depends on the endpoint.
Example:
{
    "rules":[
    ]
}
Examples

Back to Top