REST API for Clinical One Cloud Service

v2.0

get

/ec-rule-designer-svc/rest/v2.0/rule/studies/{studyId}/{mode}/simple

Retrieves rule summaries with the extended filtering set introduced for the rule designer grid. Compared to v1.0, v2.0 adds pagination controls (offset, limit), grid layout toggles, server-side sorting, and advanced text filtering used by the redesigned workspace. This benefits users by making large rule sets faster to navigate and triage.

Request

Path Parameters

mode(required): string
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
```
studyId(required): string(uuid)
Unique study identifier supplied as a UUID. Accepts either a compact 32-character hexadecimal value or a hyphenated 36-character UUID.
Example:
```
36753A48BBA048CB98A5F3278146118D
```

Query Parameters

eventId: string(uuid)
Minimum Length: 32

Maximum Length: 36

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Optional event identifier. When supplied, responses include rules bound to the given event or unbound rules.
Example:
```
9B4AA96F48344015A259D6436EB97B47
```
filterView: string
Minimum Length: 1

Maximum Length: 32

Optional named filter preset applied in the designer UI (for example Filter, Favorites). Provide up to 32 characters.
Example:
```
Filter
```
formId: string(uuid)
Minimum Length: 32

Maximum Length: 36

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Optional form identifier filter. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.
Example:
```
39903D6C042D4D9E89773160488E6D3D
```
gridView: string
Minimum Length: 2

Maximum Length: 16

Optional UI layout selector. Allowed values: Grid (card layout) or List (tabular layout).
Example:
```
Grid
```
itemId: string(uuid)
Minimum Length: 32

Maximum Length: 36

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Optional item identifier. Helps locate rules where the item is either an operand or the action target.
Example:
```
2F4F4E67E0CE4BE0BB9544D2CD38A569
```
limit: integer(int32)
Minimum Value: 1

Maximum Value: 500

Page size for pagination. Supply an integer between 1 and 500.
Example:
```
50
```
offset: integer(int32)
Minimum Value: 0

Zero-based offset for pagination. Supply a non-negative integer.
Example:
```
0
```
propertyName: string
Minimum Length: 1

Maximum Length: 128

Optional property name filter used together with propertyType and eventId to resolve visit metadata.
Example:
```
visitStartDate
```
propertyType: string
Minimum Length: 4

Maximum Length: 5

Optional property type filter used with propertyName and eventId. Allowed values: visit (filters by visit definition), event (limits results to a specific event), form (targets form-level attributes), item (targets a single item operand or action), and none (returns all property types).

Allowed Values: [ "visit", "event", "form", "item", "none" ]
Example:
```
visit
```
ruleId: string(uuid)
Minimum Length: 32

Maximum Length: 36

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Rule identifier. Required for path parameters targeting a single rule; optional when used as a query filter.
Example:
```
8E2253D8E53A4A46BAE3E4952CBE9E5A
```
ruleName: string
Minimum Length: 1

Maximum Length: 256

Optional rule name filter. Provide the user-facing title assigned to the rule.
Example:
```
Visit Start Date Validation
```
searchString: string
Minimum Length: 1

Maximum Length: 256

Optional keyword filter applied to rule names or descriptions. Provide 1 to 256 characters.
Example:
```
visitStartDate
```
sortColumn: string
Minimum Length: 1

Maximum Length: 64

Column name used for sorting (for example ruleName, ruleState). Provide 1 to 64 characters.
Example:
```
ruleName
```
sortOrder: string
Minimum Length: 3

Maximum Length: 4

Sort order for the selected column. Allowed values: ASC (ascending) or DESC (descending).

Allowed Values: [ "ASC", "DESC" ]
Example:
```
ASC
```

There's no request body for this operation.

Response

Supported Media Types

application/json

200 Response

Success.

Root Schema : RuleSimpleListDoc

Type: object

Rule collection returned by lightweight listing endpoints.

Show Source

rules: array rules

Rule summaries returned by the lightweight endpoint.

{
    "type":"object",
    "properties":{
        "rules":{
            "type":"array",
            "description":"Rule summaries returned by the lightweight endpoint.",
            "example":[
                {
                    "ruleId":"699EF3745FC545589F186D2198F3C65E",
                    "ruleName":"Query on negative temperature",
                    "ruleValidationStatus":"true"
                }
            ],
            "items":{
                "$ref":"#/components/schemas/RuleSummaryDoc"
            }
        }
    },
    "description":"Rule collection returned by lightweight listing endpoints."
}

Nested Schema : rules

Type: array

Rule summaries returned by the lightweight endpoint.

Show Source

Array of: object RuleSummaryDoc

Rule summary entry returned by the list endpoints.

{
    "type":"array",
    "description":"Rule summaries returned by the lightweight endpoint.",
    "example":[
        {
            "ruleId":"699EF3745FC545589F186D2198F3C65E",
            "ruleName":"Query on negative temperature",
            "ruleValidationStatus":"true"
        }
    ],
    "items":{
        "$ref":"#/components/schemas/RuleSummaryDoc"
    }
}

Example:

[
    {
        "ruleId":"699EF3745FC545589F186D2198F3C65E",
        "ruleName":"Query on negative temperature",
        "ruleValidationStatus":"true"
    }
]

Nested Schema : RuleSummaryDoc

Type: object

Rule summary entry returned by the list endpoints.

Show Source

actions: array actions

Actions triggered when the rule evaluates to true.
operands: array operands

Operands referenced when the rule executes.
ruleDescription: string

Business purpose or description of the rule.

Example: Creates a query when visit date falls outside the allowable window.
ruleId(required): string

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Unique identifier of the rule. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.

Example: 82A65F8F6AAF47FFB177662E3931E7C0
ruleName(required): string

Human readable rule name displayed in the designer UI.

Example: Visit Start Date Validation
ruleOriginType: string

Allowed Values: [ "UI", "API", "INTEGRATION" ]

Origin of the rule configuration.

Example: UI
ruleValidationMessage: string

Text explaining the latest validation result.

Example: Rule evaluated successfully.
ruleValidationStatus: string

Allowed Values: [ "true", "false" ]

Validation result indicator. `true` means validation passed; `false` indicates warnings or errors.

Example: true

{
    "required":[
        "ruleId",
        "ruleName"
    ],
    "type":"object",
    "properties":{
        "ruleId":{
            "pattern":"^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
            "type":"string",
            "description":"Unique identifier of the rule. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.",
            "example":"82A65F8F6AAF47FFB177662E3931E7C0"
        },
        "ruleName":{
            "type":"string",
            "description":"Human readable rule name displayed in the designer UI.",
            "example":"Visit Start Date Validation"
        },
        "ruleDescription":{
            "type":"string",
            "description":"Business purpose or description of the rule.",
            "nullable":true,
            "example":"Creates a query when visit date falls outside the allowable window."
        },
        "ruleValidationStatus":{
            "type":"string",
            "description":"Validation result indicator. `true` means validation passed; `false` indicates warnings or errors.",
            "nullable":true,
            "example":"true",
            "enum":[
                "true",
                "false"
            ]
        },
        "ruleValidationMessage":{
            "type":"string",
            "description":"Text explaining the latest validation result.",
            "nullable":true,
            "example":"Rule evaluated successfully."
        },
        "ruleOriginType":{
            "type":"string",
            "description":"Origin of the rule configuration.",
            "nullable":true,
            "example":"UI",
            "enum":[
                "UI",
                "API",
                "INTEGRATION"
            ]
        },
        "actions":{
            "type":"array",
            "description":"Actions triggered when the rule evaluates to true.",
            "example":[
                {
                    "ruleActionTypeName":"CREATE_QUERY",
                    "formId":"39903D6C042D4D9E89773160488E6D3D"
                }
            ],
            "items":{
                "$ref":"#/components/schemas/RuleSummaryActionDoc"
            }
        },
        "operands":{
            "type":"array",
            "description":"Operands referenced when the rule executes.",
            "example":[
                {
                    "formId":"39903D6C042D4D9E89773160488E6D3D",
                    "itemId":"2F4F4E67E0CE4BE0BB9544D2CD38A569"
                }
            ],
            "items":{
                "$ref":"#/components/schemas/RuleSummaryOperandDoc"
            }
        }
    },
    "description":"Rule summary entry returned by the list endpoints.",
    "example":{
        "ruleId":"82A65F8F6AAF47FFB177662E3931E7C0",
        "ruleName":"Visit Start Date Validation",
        "ruleOriginType":"UI"
    }
}

Example:

{
    "ruleId":"82A65F8F6AAF47FFB177662E3931E7C0",
    "ruleName":"Visit Start Date Validation",
    "ruleOriginType":"UI"
}

Nested Schema : actions

Type: array

Actions triggered when the rule evaluates to true.

Show Source

Array of: object RuleSummaryActionDoc

Action metadata describing what happens when the rule triggers.

{
    "type":"array",
    "description":"Actions triggered when the rule evaluates to true.",
    "example":[
        {
            "ruleActionTypeName":"CREATE_QUERY",
            "formId":"39903D6C042D4D9E89773160488E6D3D"
        }
    ],
    "items":{
        "$ref":"#/components/schemas/RuleSummaryActionDoc"
    }
}

Example:

[
    {
        "ruleActionTypeName":"CREATE_QUERY",
        "formId":"39903D6C042D4D9E89773160488E6D3D"
    }
]

Nested Schema : operands

Type: array

Operands referenced when the rule executes.

Show Source

Array of: object RuleSummaryOperandDoc

Operand metadata used while evaluating the rule.

{
    "type":"array",
    "description":"Operands referenced when the rule executes.",
    "example":[
        {
            "formId":"39903D6C042D4D9E89773160488E6D3D",
            "itemId":"2F4F4E67E0CE4BE0BB9544D2CD38A569"
        }
    ],
    "items":{
        "$ref":"#/components/schemas/RuleSummaryOperandDoc"
    }
}

Example:

[
    {
        "formId":"39903D6C042D4D9E89773160488E6D3D",
        "itemId":"2F4F4E67E0CE4BE0BB9544D2CD38A569"
    }
]

Nested Schema : RuleSummaryActionDoc

Type: object

Action metadata describing what happens when the rule triggers.

Show Source

eventId: string

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Identifier of the event targeted by the action.

Example: 9B4AA96F48344015A259D6436EB97B47
formId: string

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Unique identifier of the action target form.

Example: 39903D6C042D4D9E89773160488E6D3D
itemId: string

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Unique identifier of the action target item.

Example: 2F4F4E67E0CE4BE0BB9544D2CD38A569
propertyName: string

Specific property referenced by the action.

Example: VISIT_START
propertyType: string

Allowed Values: [ "visit", "event", "form", "item", "none" ]

Optional property type affected by the action.

Example: form
ruleActionTypeName: string

Allowed Values: [ "CREATE_QUERY", "SEND_NOTIFICATION", "DISABLE_FIELD", "EXECUTE_CUSTOM_ACTION" ]

Action type performed when the rule fires.

Example: CREATE_QUERY

{
    "type":"object",
    "properties":{
        "formId":{
            "pattern":"^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
            "type":"string",
            "description":"Unique identifier of the action target form.",
            "nullable":true,
            "example":"39903D6C042D4D9E89773160488E6D3D"
        },
        "itemId":{
            "pattern":"^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
            "type":"string",
            "description":"Unique identifier of the action target item.",
            "nullable":true,
            "example":"2F4F4E67E0CE4BE0BB9544D2CD38A569"
        },
        "ruleActionTypeName":{
            "type":"string",
            "description":"Action type performed when the rule fires.",
            "nullable":true,
            "example":"CREATE_QUERY",
            "enum":[
                "CREATE_QUERY",
                "SEND_NOTIFICATION",
                "DISABLE_FIELD",
                "EXECUTE_CUSTOM_ACTION"
            ]
        },
        "propertyType":{
            "type":"string",
            "description":"Optional property type affected by the action.",
            "nullable":true,
            "example":"form",
            "enum":[
                "visit",
                "event",
                "form",
                "item",
                "none"
            ]
        },
        "propertyName":{
            "type":"string",
            "description":"Specific property referenced by the action.",
            "nullable":true,
            "example":"VISIT_START"
        },
        "eventId":{
            "pattern":"^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
            "type":"string",
            "description":"Identifier of the event targeted by the action.",
            "nullable":true,
            "example":"9B4AA96F48344015A259D6436EB97B47"
        }
    },
    "description":"Action metadata describing what happens when the rule triggers."
}

Nested Schema : RuleSummaryOperandDoc

Type: object

Operand metadata used while evaluating the rule.

Show Source

eventId: string

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Unique identifier of the operand event.

Example: 9B4AA96F48344015A259D6436EB97B47
formId: string

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Unique identifier of the operand form.

Example: 39903D6C042D4D9E89773160488E6D3D
itemId: string

Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Unique identifier of the operand item.

Example: 2F4F4E67E0CE4BE0BB9544D2CD38A569
mapRelation: string

Allowed Values: [ "ANY", "ALL", "NONE" ]

Relationship between this operand and the other operands.

Example: ALL

{
    "type":"object",
    "properties":{
        "eventId":{
            "pattern":"^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
            "type":"string",
            "description":"Unique identifier of the operand event.",
            "nullable":true,
            "example":"9B4AA96F48344015A259D6436EB97B47"
        },
        "formId":{
            "pattern":"^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
            "type":"string",
            "description":"Unique identifier of the operand form.",
            "nullable":true,
            "example":"39903D6C042D4D9E89773160488E6D3D"
        },
        "itemId":{
            "pattern":"^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
            "type":"string",
            "description":"Unique identifier of the operand item.",
            "nullable":true,
            "example":"2F4F4E67E0CE4BE0BB9544D2CD38A569"
        },
        "mapRelation":{
            "type":"string",
            "description":"Relationship between this operand and the other operands.",
            "nullable":true,
            "example":"ALL",
            "enum":[
                "ANY",
                "ALL",
                "NONE"
            ]
        }
    },
    "description":"Operand metadata used while evaluating the rule."
}

Examples

400 Response

Returned when the supplied parameters fail validation or use an unsupported combination of filter values.

Root Schema : RuleSummaryErrorDoc

Type: object

Error structure returned when a rule list request fails.

Show Source

details: string

Optional context giving additional remediation detail.

Example: Provide at least one ruleId in the query.
errorCode(required): string

Machine readable error code.

Example: RuleSvc-030
errorMessage(required): string

Human-readable explanation that helps resolve the failure.

Example: Invalid UUID list. One or more elements are invalid. Must contain at least one element.
result: string

Successful payload content is null for errors.

Example: null
status(required): string

Allowed Values: [ "failed" ]

Status string indicating the request failed.

Example: failed

{
    "required":[
        "errorCode",
        "errorMessage",
        "status"
    ],
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status string indicating the request failed.",
            "example":"failed",
            "enum":[
                "failed"
            ]
        },
        "result":{
            "type":"string",
            "description":"Successful payload content is null for errors.",
            "nullable":true,
            "example":"null"
        },
        "errorCode":{
            "type":"string",
            "description":"Machine readable error code.",
            "example":"RuleSvc-030"
        },
        "errorMessage":{
            "type":"string",
            "description":"Human-readable explanation that helps resolve the failure.",
            "example":"Invalid UUID list. One or more elements are invalid. Must contain at least one element."
        },
        "details":{
            "type":"string",
            "description":"Optional context giving additional remediation detail.",
            "nullable":true,
            "example":"Provide at least one ruleId in the query."
        }
    },
    "description":"Error structure returned when a rule list request fails."
}

Examples

500 Response

Returned when the service encounters an unexpected server-side error while processing the request.

Root Schema : RuleSummaryErrorDoc

Type: object

Error structure returned when a rule list request fails.

Show Source

details: string

Optional context giving additional remediation detail.

Example: Provide at least one ruleId in the query.
errorCode(required): string

Machine readable error code.

Example: RuleSvc-030
errorMessage(required): string

Human-readable explanation that helps resolve the failure.

Example: Invalid UUID list. One or more elements are invalid. Must contain at least one element.
result: string

Successful payload content is null for errors.

Example: null
status(required): string

Allowed Values: [ "failed" ]

Status string indicating the request failed.

Example: failed

{
    "required":[
        "errorCode",
        "errorMessage",
        "status"
    ],
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status string indicating the request failed.",
            "example":"failed",
            "enum":[
                "failed"
            ]
        },
        "result":{
            "type":"string",
            "description":"Successful payload content is null for errors.",
            "nullable":true,
            "example":"null"
        },
        "errorCode":{
            "type":"string",
            "description":"Machine readable error code.",
            "example":"RuleSvc-030"
        },
        "errorMessage":{
            "type":"string",
            "description":"Human-readable explanation that helps resolve the failure.",
            "example":"Invalid UUID list. One or more elements are invalid. Must contain at least one element."
        },
        "details":{
            "type":"string",
            "description":"Optional context giving additional remediation detail.",
            "nullable":true,
            "example":"Provide at least one ruleId in the query."
        }
    },
    "description":"Error structure returned when a rule list request fails."
}

Examples