REST API for Clinical One Platform

Update existing cohort group

put

/ec-designer-svc/rest/v1.0/studies/{studyId}/versions/{version}/randomizations/{randomId}/cohorts/{cohortId}

Updates a cohort group associated with a randomization.

Request

Path Parameters

cohortId(required): string(uuid)

Cohort ID.
randomId(required): string(uuid)

Randomization ID.
studyId(required): string(uuid)

Study ID. Example: F054C951EB74443C93716CA714AB686E
version(required): string

Study version. Example: "1.0.0.1"

Supported Media Types

Root Schema : CohortDto v1.0

Type: object

Title: CohortDto v1.0

Randomization Cohort Details Information

Show Source

factors: array factors
id: string (uuid)

Cohort Unique GUID
name(required): string

Minimum Length: 1

Maximum Length: 64

Cohort Name

Example: Cohort Demography Group 1
type(required): string

Allowed Values: [ "None", "Adaptive", "Demography" ]

Cohort Type

Example: Demography

{
    "title":"CohortDto v1.0",
    "required":[
        "name",
        "type"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Cohort Unique GUID",
            "format":"uuid"
        },
        "name":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Cohort Name",
            "example":"Cohort Demography Group 1"
        },
        "type":{
            "type":"string",
            "description":"Cohort Type",
            "example":"Demography",
            "enum":[
                "None",
                "Adaptive",
                "Demography"
            ]
        },
        "factors":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/CohortFactorDtoV1"
            }
        }
    },
    "description":"Randomization Cohort Details Information"
}

Nested Schema : factors

Type: array

Show Source

Array of: object CohortFactorDto v1.0

Title: CohortFactorDto v1.0

Discriminator: { "propertyName":"type", "mapping":{ "choice":"#/components/schemas/CohortChoiceFactorDtoV1", "range":"#/components/schemas/CohortRangeFactorDtoV1" } }

Randomization Cohort Factor Information

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

Nested Schema : CohortFactorDto v1.0

Type: object

Title: CohortFactorDto v1.0

Discriminator: type

{
    "title":"CohortFactorDto v1.0",
    "required":[
        "formId",
        "itemId",
        "type"
    ],
    "type":"object",
    "properties":{
        "formId":{
            "type":"string",
            "description":"Form GUID",
            "format":"uuid"
        },
        "itemId":{
            "type":"string",
            "description":"Item GUID",
            "format":"uuid"
        },
        "type":{
            "type":"string"
        }
    },
    "description":"Randomization Cohort Factor Information",
    "discriminator":{
        "propertyName":"type",
        "mapping":{
            "choice":"#/components/schemas/CohortChoiceFactorDtoV1",
            "range":"#/components/schemas/CohortRangeFactorDtoV1"
        }
    },
    "anyOf":[
        {
            "$ref":"#/components/schemas/CohortChoiceFactorDtoV1"
        },
        {
            "$ref":"#/components/schemas/CohortRangeFactorDtoV1"
        }
    ]
}

Randomization Cohort Factor Information

Show Source

formId(required): string (uuid)

Form GUID
itemId(required): string (uuid)

Item GUID
type(required): string

{
    "title":"CohortFactorDto v1.0",
    "required":[
        "formId",
        "itemId",
        "type"
    ],
    "type":"object",
    "properties":{
        "formId":{
            "type":"string",
            "description":"Form GUID",
            "format":"uuid"
        },
        "itemId":{
            "type":"string",
            "description":"Item GUID",
            "format":"uuid"
        },
        "type":{
            "type":"string"
        }
    },
    "description":"Randomization Cohort Factor Information",
    "discriminator":{
        "propertyName":"type",
        "mapping":{
            "choice":"#/components/schemas/CohortChoiceFactorDtoV1",
            "range":"#/components/schemas/CohortRangeFactorDtoV1"
        }
    },
    "anyOf":[
        {
            "$ref":"#/components/schemas/CohortChoiceFactorDtoV1"
        },
        {
            "$ref":"#/components/schemas/CohortRangeFactorDtoV1"
        }
    ]
}

Response

Supported Media Types

application/json

200 Response

Successful operation.

Root Schema : CohortDto v1.0

Type: object

Title: CohortDto v1.0

Randomization Cohort Details Information

Show Source

factors: array factors
id: string (uuid)

Cohort Unique GUID
name(required): string

Minimum Length: 1

Maximum Length: 64

Cohort Name

Example: Cohort Demography Group 1
type(required): string

Allowed Values: [ "None", "Adaptive", "Demography" ]

Cohort Type

Example: Demography

{
    "title":"CohortDto v1.0",
    "required":[
        "name",
        "type"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Cohort Unique GUID",
            "format":"uuid"
        },
        "name":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Cohort Name",
            "example":"Cohort Demography Group 1"
        },
        "type":{
            "type":"string",
            "description":"Cohort Type",
            "example":"Demography",
            "enum":[
                "None",
                "Adaptive",
                "Demography"
            ]
        },
        "factors":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/CohortFactorDtoV1"
            }
        }
    },
    "description":"Randomization Cohort Details Information"
}

Nested Schema : factors

Type: array

Show Source

Array of: object CohortFactorDto v1.0

Title: CohortFactorDto v1.0

Discriminator: { "propertyName":"type", "mapping":{ "choice":"#/components/schemas/CohortChoiceFactorDtoV1", "range":"#/components/schemas/CohortRangeFactorDtoV1" } }

Randomization Cohort Factor Information

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

Nested Schema : CohortFactorDto v1.0

Type: object

Title: CohortFactorDto v1.0

Discriminator: type

Discriminator Values

choice
range

{
    "title":"CohortFactorDto v1.0",
    "required":[
        "formId",
        "itemId",
        "type"
    ],
    "type":"object",
    "properties":{
        "formId":{
            "type":"string",
            "description":"Form GUID",
            "format":"uuid"
        },
        "itemId":{
            "type":"string",
            "description":"Item GUID",
            "format":"uuid"
        },
        "type":{
            "type":"string"
        }
    },
    "description":"Randomization Cohort Factor Information",
    "discriminator":{
        "propertyName":"type",
        "mapping":{
            "choice":"#/components/schemas/CohortChoiceFactorDtoV1",
            "range":"#/components/schemas/CohortRangeFactorDtoV1"
        }
    },
    "anyOf":[
        {
            "$ref":"#/components/schemas/CohortChoiceFactorDtoV1"
        },
        {
            "$ref":"#/components/schemas/CohortRangeFactorDtoV1"
        }
    ]
}

Randomization Cohort Factor Information

Show Source

formId(required): string (uuid)

Form GUID
itemId(required): string (uuid)

Item GUID
type(required): string

{
    "title":"CohortFactorDto v1.0",
    "required":[
        "formId",
        "itemId",
        "type"
    ],
    "type":"object",
    "properties":{
        "formId":{
            "type":"string",
            "description":"Form GUID",
            "format":"uuid"
        },
        "itemId":{
            "type":"string",
            "description":"Item GUID",
            "format":"uuid"
        },
        "type":{
            "type":"string"
        }
    },
    "description":"Randomization Cohort Factor Information",
    "discriminator":{
        "propertyName":"type",
        "mapping":{
            "choice":"#/components/schemas/CohortChoiceFactorDtoV1",
            "range":"#/components/schemas/CohortRangeFactorDtoV1"
        }
    },
    "anyOf":[
        {
            "$ref":"#/components/schemas/CohortChoiceFactorDtoV1"
        },
        {
            "$ref":"#/components/schemas/CohortRangeFactorDtoV1"
        }
    ]
}

500 Response

Error

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