REST API for Clinical One Cloud Service

V3.0

put

/ec-designer-ors-svc/rest/v3.0/studies/{studyId}/versions/{version}/randomizations/{randomId}/strata/bulk

Updates a list of cohort groups associated with a randomization design.

Request

Path Parameters

randomId(required): string(uuid)

Randomization ID
studyId(required): string(uuid)

Study unique identifier.
version(required): string

Study version identifier.

Supported Media Types

application/json

Root Schema : schema

Type: array

Show Source

Array of: object StrataBulkItemV3

Bulk strata request and response payload item for the v3 strata APIs.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/StrataBulkItemV3"
    }
}

Nested Schema : StrataBulkItemV3

Type: object

Bulk strata request and response payload item for the v3 strata APIs.

Show Source

factors: array factors

Stratification factors associated with the stratum.
id: string (uuid)

Minimum Length: 32

Maximum Length: 32

Stratum unique identifier.
name: string

Minimum Length: 1

Maximum Length: 64

Stratum display name.

Example: Stratum Group 1
objectId: string (uuid)

Minimum Length: 32

Maximum Length: 32

Object unique identifier associated with the objectType.
objectType: string

Minimum Length: 4

Maximum Length: 9

Allowed Values: [ "Code List", "Site", "Country", "Region" ]

Object type used by adaptive strata. Allowed values: Code List = coded factor source, Site = site-based factor source, Country = country-based factor source, Region = region-based factor source.

Example: Code List
parentCohortId: string (uuid)

Minimum Length: 32

Maximum Length: 32

Parent cohort unique identifier when the stratum belongs to a cohort.
parentCohortName: string

Minimum Length: 1

Maximum Length: 64

Parent cohort name when the stratum belongs to a cohort.

Example: Adult Cohort
randomizationType: string

Minimum Length: 10

Maximum Length: 19

Allowed Values: [ "Stratified", "Adaptive Stratified" ]

Randomization type for the stratum. Allowed values: Stratified = standard stratified randomization stratum, Adaptive Stratified = adaptive stratified randomization stratum.

Example: Stratified
weight: integer (int32)

Minimum Value: 0

Weight assigned to the stratum when weighted selection is used.

Example: 1

{
    "type":"object",
    "properties":{
        "id":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Stratum unique identifier.",
            "format":"uuid"
        },
        "name":{
            "maxLength":64,
            "minLength":1,
            "type":"string",
            "description":"Stratum display name.",
            "example":"Stratum Group 1"
        },
        "parentCohortName":{
            "maxLength":64,
            "minLength":1,
            "type":"string",
            "description":"Parent cohort name when the stratum belongs to a cohort.",
            "example":"Adult Cohort"
        },
        "parentCohortId":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Parent cohort unique identifier when the stratum belongs to a cohort.",
            "format":"uuid"
        },
        "factors":{
            "type":"array",
            "description":"Stratification factors associated with the stratum.",
            "example":[
                {
                    "type":"choice",
                    "formId":"D1B8327AFAA6412287106192AB5984EF",
                    "itemId":"E1B8327AFAA6412287106192AB5984EF",
                    "groupName":"Age Group",
                    "groupId":"F1B8327AFAA6412287106192AB5984EF",
                    "values":[
                        "18-40",
                        "41-65"
                    ],
                    "codelistitemIds":[
                        "977443BF3EFB43888026788E7F7CCE96",
                        "877443BF3EFB43888026788E7F7CCE95"
                    ]
                }
            ],
            "items":{
                "$ref":"#/components/schemas/StrataBulkFactorV3"
            }
        },
        "weight":{
            "minimum":0,
            "type":"integer",
            "description":"Weight assigned to the stratum when weighted selection is used.",
            "format":"int32",
            "example":1
        },
        "randomizationType":{
            "maxLength":19,
            "minLength":10,
            "type":"string",
            "description":"Randomization type for the stratum. Allowed values: Stratified = standard stratified randomization stratum, Adaptive Stratified = adaptive stratified randomization stratum.",
            "example":"Stratified",
            "enum":[
                "Stratified",
                "Adaptive Stratified"
            ]
        },
        "objectType":{
            "maxLength":9,
            "minLength":4,
            "type":"string",
            "description":"Object type used by adaptive strata. Allowed values: Code List = coded factor source, Site = site-based factor source, Country = country-based factor source, Region = region-based factor source.",
            "example":"Code List",
            "enum":[
                "Code List",
                "Site",
                "Country",
                "Region"
            ]
        },
        "objectId":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Object unique identifier associated with the objectType.",
            "format":"uuid"
        }
    },
    "description":"Bulk strata request and response payload item for the v3 strata APIs."
}

Nested Schema : factors

Type: array

Stratification factors associated with the stratum.

Show Source

Array of: object StrataBulkFactorV3

Stratification factor details used in bulk strata request and response payloads.

{
    "type":"array",
    "description":"Stratification factors associated with the stratum.",
    "example":[
        {
            "type":"choice",
            "formId":"D1B8327AFAA6412287106192AB5984EF",
            "itemId":"E1B8327AFAA6412287106192AB5984EF",
            "groupName":"Age Group",
            "groupId":"F1B8327AFAA6412287106192AB5984EF",
            "values":[
                "18-40",
                "41-65"
            ],
            "codelistitemIds":[
                "977443BF3EFB43888026788E7F7CCE96",
                "877443BF3EFB43888026788E7F7CCE95"
            ]
        }
    ],
    "items":{
        "$ref":"#/components/schemas/StrataBulkFactorV3"
    }
}

Example:

[
    {
        "type":"choice",
        "formId":"D1B8327AFAA6412287106192AB5984EF",
        "itemId":"E1B8327AFAA6412287106192AB5984EF",
        "groupName":"Age Group",
        "groupId":"F1B8327AFAA6412287106192AB5984EF",
        "values":[
            "18-40",
            "41-65"
        ],
        "codelistitemIds":[
            "977443BF3EFB43888026788E7F7CCE96",
            "877443BF3EFB43888026788E7F7CCE95"
        ]
    }
]

Nested Schema : StrataBulkFactorV3

Type: object

Stratification factor details used in bulk strata request and response payloads.

Show Source

codelistitemIds: array codelistitemIds

Selected code list item identifiers for a choice-based factor.
formId: string (uuid)

Minimum Length: 32

Maximum Length: 32

Form unique identifier that owns the factor item.
groupId: string (uuid)

Minimum Length: 32

Maximum Length: 32

Factor group unique identifier.
groupName: string

Minimum Length: 1

Maximum Length: 64

Factor group display name.

Example: Age Group
itemId: string (uuid)

Minimum Length: 32

Maximum Length: 32

Form item unique identifier for the factor item.
max: number (double)

Maximum numeric value for a range-based factor. Negative values are allowed when the linked numeric form item permits them.

Example: 30
min: number (double)

Minimum numeric value for a range-based factor. Negative values are allowed when the linked numeric form item permits them.

Example: 18
type: string

Minimum Length: 5

Maximum Length: 6

Allowed Values: [ "choice", "range" ]

Factor type. Allowed values: choice = factor based on one or more coded choice values, range = factor based on a numeric range.

Example: choice
values: array values

Selected display values for a choice-based factor.

{
    "type":"object",
    "properties":{
        "type":{
            "maxLength":6,
            "minLength":5,
            "type":"string",
            "description":"Factor type. Allowed values: choice = factor based on one or more coded choice values, range = factor based on a numeric range.",
            "example":"choice",
            "enum":[
                "choice",
                "range"
            ]
        },
        "formId":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Form unique identifier that owns the factor item.",
            "format":"uuid"
        },
        "itemId":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Form item unique identifier for the factor item.",
            "format":"uuid"
        },
        "groupName":{
            "maxLength":64,
            "minLength":1,
            "type":"string",
            "description":"Factor group display name.",
            "example":"Age Group"
        },
        "groupId":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Factor group unique identifier.",
            "format":"uuid"
        },
        "values":{
            "type":"array",
            "description":"Selected display values for a choice-based factor.",
            "example":[
                "18-40",
                "41-65"
            ],
            "items":{
                "maxLength":255,
                "minLength":1,
                "type":"string",
                "example":"18-40"
            }
        },
        "codelistitemIds":{
            "type":"array",
            "description":"Selected code list item identifiers for a choice-based factor.",
            "example":[
                "977443BF3EFB43888026788E7F7CCE96",
                "877443BF3EFB43888026788E7F7CCE95"
            ],
            "items":{
                "maxLength":32,
                "minLength":32,
                "type":"string",
                "format":"uuid"
            }
        },
        "min":{
            "type":"number",
            "description":"Minimum numeric value for a range-based factor. Negative values are allowed when the linked numeric form item permits them.",
            "format":"double",
            "example":18
        },
        "max":{
            "type":"number",
            "description":"Maximum numeric value for a range-based factor. Negative values are allowed when the linked numeric form item permits them.",
            "format":"double",
            "example":30
        }
    },
    "description":"Stratification factor details used in bulk strata request and response payloads."
}

Nested Schema : codelistitemIds

Type: array

Selected code list item identifiers for a choice-based factor.

Show Source

Array of: string(uuid)

Minimum Length: 32

Maximum Length: 32

{
    "type":"array",
    "description":"Selected code list item identifiers for a choice-based factor.",
    "example":[
        "977443BF3EFB43888026788E7F7CCE96",
        "877443BF3EFB43888026788E7F7CCE95"
    ],
    "items":{
        "maxLength":32,
        "minLength":32,
        "type":"string",
        "format":"uuid"
    }
}

Example:

[
    "977443BF3EFB43888026788E7F7CCE96",
    "877443BF3EFB43888026788E7F7CCE95"
]

Nested Schema : values

Type: array

Selected display values for a choice-based factor.

Show Source

Array of: string

Minimum Length: 1

Maximum Length: 255

Example: 18-40

{
    "type":"array",
    "description":"Selected display values for a choice-based factor.",
    "example":[
        "18-40",
        "41-65"
    ],
    "items":{
        "maxLength":255,
        "minLength":1,
        "type":"string",
        "example":"18-40"
    }
}

Example:

[
    "18-40",
    "41-65"
]

Examples

Response

Supported Media Types

application/json

200 Response

Successful operation.

Root Schema : schema

Type: array

Show Source

Array of: object StrataBulkItemV3

Bulk strata request and response payload item for the v3 strata APIs.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/StrataBulkItemV3"
    }
}

Nested Schema : StrataBulkItemV3

Type: object

Bulk strata request and response payload item for the v3 strata APIs.

Show Source

factors: array factors

Stratification factors associated with the stratum.
id: string (uuid)

Minimum Length: 32

Maximum Length: 32

Stratum unique identifier.
name: string

Minimum Length: 1

Maximum Length: 64

Stratum display name.

Example: Stratum Group 1
objectId: string (uuid)

Minimum Length: 32

Maximum Length: 32

Object unique identifier associated with the objectType.
objectType: string

Minimum Length: 4

Maximum Length: 9

Allowed Values: [ "Code List", "Site", "Country", "Region" ]

Object type used by adaptive strata. Allowed values: Code List = coded factor source, Site = site-based factor source, Country = country-based factor source, Region = region-based factor source.

Example: Code List
parentCohortId: string (uuid)

Minimum Length: 32

Maximum Length: 32

Parent cohort unique identifier when the stratum belongs to a cohort.
parentCohortName: string

Minimum Length: 1

Maximum Length: 64

Parent cohort name when the stratum belongs to a cohort.

Example: Adult Cohort
randomizationType: string

Minimum Length: 10

Maximum Length: 19

Allowed Values: [ "Stratified", "Adaptive Stratified" ]

Randomization type for the stratum. Allowed values: Stratified = standard stratified randomization stratum, Adaptive Stratified = adaptive stratified randomization stratum.

Example: Stratified
weight: integer (int32)

Minimum Value: 0

Weight assigned to the stratum when weighted selection is used.

Example: 1

{
    "type":"object",
    "properties":{
        "id":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Stratum unique identifier.",
            "format":"uuid"
        },
        "name":{
            "maxLength":64,
            "minLength":1,
            "type":"string",
            "description":"Stratum display name.",
            "example":"Stratum Group 1"
        },
        "parentCohortName":{
            "maxLength":64,
            "minLength":1,
            "type":"string",
            "description":"Parent cohort name when the stratum belongs to a cohort.",
            "example":"Adult Cohort"
        },
        "parentCohortId":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Parent cohort unique identifier when the stratum belongs to a cohort.",
            "format":"uuid"
        },
        "factors":{
            "type":"array",
            "description":"Stratification factors associated with the stratum.",
            "example":[
                {
                    "type":"choice",
                    "formId":"D1B8327AFAA6412287106192AB5984EF",
                    "itemId":"E1B8327AFAA6412287106192AB5984EF",
                    "groupName":"Age Group",
                    "groupId":"F1B8327AFAA6412287106192AB5984EF",
                    "values":[
                        "18-40",
                        "41-65"
                    ],
                    "codelistitemIds":[
                        "977443BF3EFB43888026788E7F7CCE96",
                        "877443BF3EFB43888026788E7F7CCE95"
                    ]
                }
            ],
            "items":{
                "$ref":"#/components/schemas/StrataBulkFactorV3"
            }
        },
        "weight":{
            "minimum":0,
            "type":"integer",
            "description":"Weight assigned to the stratum when weighted selection is used.",
            "format":"int32",
            "example":1
        },
        "randomizationType":{
            "maxLength":19,
            "minLength":10,
            "type":"string",
            "description":"Randomization type for the stratum. Allowed values: Stratified = standard stratified randomization stratum, Adaptive Stratified = adaptive stratified randomization stratum.",
            "example":"Stratified",
            "enum":[
                "Stratified",
                "Adaptive Stratified"
            ]
        },
        "objectType":{
            "maxLength":9,
            "minLength":4,
            "type":"string",
            "description":"Object type used by adaptive strata. Allowed values: Code List = coded factor source, Site = site-based factor source, Country = country-based factor source, Region = region-based factor source.",
            "example":"Code List",
            "enum":[
                "Code List",
                "Site",
                "Country",
                "Region"
            ]
        },
        "objectId":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Object unique identifier associated with the objectType.",
            "format":"uuid"
        }
    },
    "description":"Bulk strata request and response payload item for the v3 strata APIs."
}

Nested Schema : factors

Type: array

Stratification factors associated with the stratum.

Show Source

Array of: object StrataBulkFactorV3

Stratification factor details used in bulk strata request and response payloads.

{
    "type":"array",
    "description":"Stratification factors associated with the stratum.",
    "example":[
        {
            "type":"choice",
            "formId":"D1B8327AFAA6412287106192AB5984EF",
            "itemId":"E1B8327AFAA6412287106192AB5984EF",
            "groupName":"Age Group",
            "groupId":"F1B8327AFAA6412287106192AB5984EF",
            "values":[
                "18-40",
                "41-65"
            ],
            "codelistitemIds":[
                "977443BF3EFB43888026788E7F7CCE96",
                "877443BF3EFB43888026788E7F7CCE95"
            ]
        }
    ],
    "items":{
        "$ref":"#/components/schemas/StrataBulkFactorV3"
    }
}

Example:

[
    {
        "type":"choice",
        "formId":"D1B8327AFAA6412287106192AB5984EF",
        "itemId":"E1B8327AFAA6412287106192AB5984EF",
        "groupName":"Age Group",
        "groupId":"F1B8327AFAA6412287106192AB5984EF",
        "values":[
            "18-40",
            "41-65"
        ],
        "codelistitemIds":[
            "977443BF3EFB43888026788E7F7CCE96",
            "877443BF3EFB43888026788E7F7CCE95"
        ]
    }
]

Nested Schema : StrataBulkFactorV3

Type: object

Stratification factor details used in bulk strata request and response payloads.

Show Source

codelistitemIds: array codelistitemIds

Selected code list item identifiers for a choice-based factor.
formId: string (uuid)

Minimum Length: 32

Maximum Length: 32

Form unique identifier that owns the factor item.
groupId: string (uuid)

Minimum Length: 32

Maximum Length: 32

Factor group unique identifier.
groupName: string

Minimum Length: 1

Maximum Length: 64

Factor group display name.

Example: Age Group
itemId: string (uuid)

Minimum Length: 32

Maximum Length: 32

Form item unique identifier for the factor item.
max: number (double)

Maximum numeric value for a range-based factor. Negative values are allowed when the linked numeric form item permits them.

Example: 30
min: number (double)

Minimum numeric value for a range-based factor. Negative values are allowed when the linked numeric form item permits them.

Example: 18
type: string

Minimum Length: 5

Maximum Length: 6

Allowed Values: [ "choice", "range" ]

Factor type. Allowed values: choice = factor based on one or more coded choice values, range = factor based on a numeric range.

Example: choice
values: array values

Selected display values for a choice-based factor.

{
    "type":"object",
    "properties":{
        "type":{
            "maxLength":6,
            "minLength":5,
            "type":"string",
            "description":"Factor type. Allowed values: choice = factor based on one or more coded choice values, range = factor based on a numeric range.",
            "example":"choice",
            "enum":[
                "choice",
                "range"
            ]
        },
        "formId":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Form unique identifier that owns the factor item.",
            "format":"uuid"
        },
        "itemId":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Form item unique identifier for the factor item.",
            "format":"uuid"
        },
        "groupName":{
            "maxLength":64,
            "minLength":1,
            "type":"string",
            "description":"Factor group display name.",
            "example":"Age Group"
        },
        "groupId":{
            "maxLength":32,
            "minLength":32,
            "type":"string",
            "description":"Factor group unique identifier.",
            "format":"uuid"
        },
        "values":{
            "type":"array",
            "description":"Selected display values for a choice-based factor.",
            "example":[
                "18-40",
                "41-65"
            ],
            "items":{
                "maxLength":255,
                "minLength":1,
                "type":"string",
                "example":"18-40"
            }
        },
        "codelistitemIds":{
            "type":"array",
            "description":"Selected code list item identifiers for a choice-based factor.",
            "example":[
                "977443BF3EFB43888026788E7F7CCE96",
                "877443BF3EFB43888026788E7F7CCE95"
            ],
            "items":{
                "maxLength":32,
                "minLength":32,
                "type":"string",
                "format":"uuid"
            }
        },
        "min":{
            "type":"number",
            "description":"Minimum numeric value for a range-based factor. Negative values are allowed when the linked numeric form item permits them.",
            "format":"double",
            "example":18
        },
        "max":{
            "type":"number",
            "description":"Maximum numeric value for a range-based factor. Negative values are allowed when the linked numeric form item permits them.",
            "format":"double",
            "example":30
        }
    },
    "description":"Stratification factor details used in bulk strata request and response payloads."
}

Nested Schema : codelistitemIds

Type: array

Selected code list item identifiers for a choice-based factor.

Show Source

Array of: string(uuid)

Minimum Length: 32

Maximum Length: 32

{
    "type":"array",
    "description":"Selected code list item identifiers for a choice-based factor.",
    "example":[
        "977443BF3EFB43888026788E7F7CCE96",
        "877443BF3EFB43888026788E7F7CCE95"
    ],
    "items":{
        "maxLength":32,
        "minLength":32,
        "type":"string",
        "format":"uuid"
    }
}

Example:

[
    "977443BF3EFB43888026788E7F7CCE96",
    "877443BF3EFB43888026788E7F7CCE95"
]

Nested Schema : values

Type: array

Selected display values for a choice-based factor.

Show Source

Array of: string

Minimum Length: 1

Maximum Length: 255

Example: 18-40

{
    "type":"array",
    "description":"Selected display values for a choice-based factor.",
    "example":[
        "18-40",
        "41-65"
    ],
    "items":{
        "maxLength":255,
        "minLength":1,
        "type":"string",
        "example":"18-40"
    }
}

Example:

[
    "18-40",
    "41-65"
]

Examples

500 Response

Returned when the service cannot update the requested strata for the supplied study version and randomization because of an unexpected server-side failure.

Root Schema : ErrorResponseData

Type: object

Show Source

details: object details
errorCode: string
errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : details

Type: object

Examples