Update a specific form

put

/ec-designer-svc/rest/v11.0/studies/{studyId}/versions/{version}/forms/{formId}

Updates a specific form in a study version.

Request

Path Parameters
Supported Media Types
Request Body - */* ()
Root Schema : FormDto v12.0
Type: object
Title: FormDto v12.0
Form Info
Show Source
Nested Schema : items
Type: array
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
Nested Schema : FormCopySourceDto v10.0
Type: object
Title: FormCopySourceDto v10.0
Form Copy Source Information
Show Source
Nested Schema : FormItemDto v12.0
Type: object
Title: FormItemDto v12.0
Discriminator: questionType

Discriminator Values

Form Item Information
Show Source
Match One Schema
Show Source
Nested Schema : advancedProps
Type: array
Show Source
Nested Schema : dataClassificationIds
Type: array
Show Source
Nested Schema : FormNumberItemDto v12.0
Type: object
Title: FormNumberItemDto v12.0
Form Number Item Details Information
Match All
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormNumberItemDto v12.0-allOf[1]
Nested Schema : FormChoiceItemDto v12.0
Type: object
Title: FormChoiceItemDto v12.0
Form Choice Item Details Information
Match All
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormChoiceItemDto v12.0-allOf[1]
Nested Schema : FormTextItemDto v12.0
Type: object
Title: FormTextItemDto v12.0
Form text Item Details Information
Match All
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormTextItemDto v12.0-allOf[1]
Nested Schema : FormDatetimeItemDto v12.0
Type: object
Title: FormDatetimeItemDto v12.0
Form DateTime Item Details Information
Match All
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormDatetimeItemDto v12.0-allOf[1]
Nested Schema : FormQuestionGroupItemDto v12.0
Type: object
Title: FormQuestionGroupItemDto v12.0
Form Question Group Item Details Information
Match All
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
Nested Schema : FormTableItemDto
Type: object
Match All
Show Source
  • FormItemDto v14.0
    Title: FormItemDto v14.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov14", "numeric":"#/components/schemas/FormNumberItemDtov14", "measurement":"#/components/schemas/FormNumberItemDtov14", "text":"#/components/schemas/FormTextItemDtov14", "choice":"#/components/schemas/FormChoiceItemDtov14", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov14", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormTableItemDto-allOf[1]
Nested Schema : FormLabelItemDto
Type: object
Match All
Show Source
  • FormItemDto v16.0
    Title: FormItemDto v16.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov16", "numeric":"#/components/schemas/FormNumberItemDtov16", "measurement":"#/components/schemas/FormNumberItemDtov16", "text":"#/components/schemas/FormTextItemDtov16", "choice":"#/components/schemas/FormChoiceItemDtov16", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov16", "table":"#/components/schemas/FormTableItemDtov16", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormLabelItemDto-allOf[1]
Nested Schema : From Item Advanced Property v12.0
Type: object
Title: From Item Advanced Property v12.0
Form Item Advanced Property
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : From Item Advanced Property Rule v12.0
Type: object
Title: From Item Advanced Property Rule v12.0
Form Item Advanced Property Rule
Show Source
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.VALUE
    Example: Yes
  • name
    Example: RolloverQuestionAnswer
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.CODELISTITEM_ID
    Example: B1B8327AFAA6412287106192AB5984EF
Nested Schema : FormNumberItemDto v12.0-allOf[1]
Type: object
Show Source
Nested Schema : FormChoiceItemDto v12.0-allOf[1]
Type: object
Show Source
Nested Schema : options
Type: array
Show Source
Nested Schema : FormOptionDto v12.0
Type: object
Title: FormOptionDto v12.0
Form choice item option details
Show Source
  • Codelist code for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Codelist description for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox label for a one specific choice.
    Example: Female
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox value for a one specific choice.
    Example: 1
Nested Schema : FormTextItemDto v12.0-allOf[1]
Type: object
Show Source
Nested Schema : FormDatetimeItemDto v12.0-allOf[1]
Type: object
Show Source
Nested Schema : FormItemDto v14.0
Type: object
Title: FormItemDto v14.0
Discriminator: questionType

Discriminator Values

Form Item Information
Show Source
Match One Schema
Show Source
Nested Schema : FormTableItemDto-allOf[1]
Type: object
Show Source
Nested Schema : FormItemDto v16.0
Type: object
Title: FormItemDto v16.0
Discriminator: questionType

Discriminator Values

Form Item Information
Show Source
Match One Schema
Show Source
Nested Schema : FormLabelItemDto-allOf[1]
Type: object
Show Source
Nested Schema : advancedProps
Type: array
Show Source
Nested Schema : options
Type: array
Show Source
Nested Schema : From Item Advanced Property With Parent v16.0
Type: object
Title: From Item Advanced Property With Parent v16.0
Form Item Advanced Property with Parent Info
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : From Item Advanced Property Rule v16.0
Type: object
Title: From Item Advanced Property Rule v16.0
Form Item Advanced Property Rule
Show Source
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.VALUE
    Example: Yes
  • name
    Example: RolloverQuestionAnswer
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.CODELISTITEM_ID
    Example: B1B8327AFAA6412287106192AB5984EF
Nested Schema : FormOptionDto v16.0
Type: object
Title: FormOptionDto v16.0
Form choice item option details
Show Source
  • Codelist code for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Codelist description for a one specific choice.
    Example: 1
  • Codelist value for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox label for a one specific choice.
    Example: Female
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox value for a one specific choice.
    Example: 1
Back to Top

Response

Supported Media Types

200 Response

Successful operation.
Body ()
Root Schema : FormDto v12.0
Type: object
Title: FormDto v12.0
Form Info
Show Source
Nested Schema : items
Type: array
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
Nested Schema : FormCopySourceDto v10.0
Type: object
Title: FormCopySourceDto v10.0
Form Copy Source Information
Show Source
Nested Schema : FormItemDto v12.0
Type: object
Title: FormItemDto v12.0
Discriminator: questionType

Discriminator Values

Form Item Information
Show Source
Match One Schema
Show Source
Nested Schema : advancedProps
Type: array
Show Source
Nested Schema : dataClassificationIds
Type: array
Show Source
Nested Schema : FormNumberItemDto v12.0
Type: object
Title: FormNumberItemDto v12.0
Form Number Item Details Information
Match All
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormNumberItemDto v12.0-allOf[1]
Nested Schema : FormChoiceItemDto v12.0
Type: object
Title: FormChoiceItemDto v12.0
Form Choice Item Details Information
Match All
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormChoiceItemDto v12.0-allOf[1]
Nested Schema : FormTextItemDto v12.0
Type: object
Title: FormTextItemDto v12.0
Form text Item Details Information
Match All
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormTextItemDto v12.0-allOf[1]
Nested Schema : FormDatetimeItemDto v12.0
Type: object
Title: FormDatetimeItemDto v12.0
Form DateTime Item Details Information
Match All
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormDatetimeItemDto v12.0-allOf[1]
Nested Schema : FormQuestionGroupItemDto v12.0
Type: object
Title: FormQuestionGroupItemDto v12.0
Form Question Group Item Details Information
Match All
Show Source
  • FormItemDto v12.0
    Title: FormItemDto v12.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov12", "numeric":"#/components/schemas/FormNumberItemDtov12", "measurement":"#/components/schemas/FormNumberItemDtov12", "text":"#/components/schemas/FormTextItemDtov12", "choice":"#/components/schemas/FormChoiceItemDtov12", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov12", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
Nested Schema : FormTableItemDto
Type: object
Match All
Show Source
  • FormItemDto v14.0
    Title: FormItemDto v14.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov14", "numeric":"#/components/schemas/FormNumberItemDtov14", "measurement":"#/components/schemas/FormNumberItemDtov14", "text":"#/components/schemas/FormTextItemDtov14", "choice":"#/components/schemas/FormChoiceItemDtov14", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov14", "table":"#/components/schemas/FormTableItemDto", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormTableItemDto-allOf[1]
Nested Schema : FormLabelItemDto
Type: object
Match All
Show Source
  • FormItemDto v16.0
    Title: FormItemDto v16.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov16", "numeric":"#/components/schemas/FormNumberItemDtov16", "measurement":"#/components/schemas/FormNumberItemDtov16", "text":"#/components/schemas/FormTextItemDtov16", "choice":"#/components/schemas/FormChoiceItemDtov16", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov16", "table":"#/components/schemas/FormTableItemDtov16", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormLabelItemDto-allOf[1]
Nested Schema : From Item Advanced Property v12.0
Type: object
Title: From Item Advanced Property v12.0
Form Item Advanced Property
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : From Item Advanced Property Rule v12.0
Type: object
Title: From Item Advanced Property Rule v12.0
Form Item Advanced Property Rule
Show Source
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.VALUE
    Example: Yes
  • name
    Example: RolloverQuestionAnswer
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.CODELISTITEM_ID
    Example: B1B8327AFAA6412287106192AB5984EF
Nested Schema : FormNumberItemDto v12.0-allOf[1]
Type: object
Show Source
Nested Schema : FormChoiceItemDto v12.0-allOf[1]
Type: object
Show Source
Nested Schema : options
Type: array
Show Source
Nested Schema : FormOptionDto v12.0
Type: object
Title: FormOptionDto v12.0
Form choice item option details
Show Source
  • Codelist code for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Codelist description for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox label for a one specific choice.
    Example: Female
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox value for a one specific choice.
    Example: 1
Nested Schema : FormTextItemDto v12.0-allOf[1]
Type: object
Show Source
Nested Schema : FormDatetimeItemDto v12.0-allOf[1]
Type: object
Show Source
Nested Schema : FormItemDto v14.0
Type: object
Title: FormItemDto v14.0
Discriminator: questionType

Discriminator Values

Form Item Information
Show Source
Match One Schema
Show Source
Nested Schema : FormTableItemDto-allOf[1]
Type: object
Show Source
Nested Schema : FormItemDto v16.0
Type: object
Title: FormItemDto v16.0
Discriminator: questionType

Discriminator Values

Form Item Information
Show Source
Match One Schema
Show Source
Nested Schema : FormLabelItemDto-allOf[1]
Type: object
Show Source
Nested Schema : advancedProps
Type: array
Show Source
Nested Schema : options
Type: array
Show Source
Nested Schema : From Item Advanced Property With Parent v16.0
Type: object
Title: From Item Advanced Property With Parent v16.0
Form Item Advanced Property with Parent Info
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : From Item Advanced Property Rule v16.0
Type: object
Title: From Item Advanced Property Rule v16.0
Form Item Advanced Property Rule
Show Source
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.VALUE
    Example: Yes
  • name
    Example: RolloverQuestionAnswer
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.CODELISTITEM_ID
    Example: B1B8327AFAA6412287106192AB5984EF
Nested Schema : FormOptionDto v16.0
Type: object
Title: FormOptionDto v16.0
Form choice item option details
Show Source
  • Codelist code for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Codelist description for a one specific choice.
    Example: 1
  • Codelist value for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox label for a one specific choice.
    Example: Female
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox value for a one specific choice.
    Example: 1

500 Response

Error
Body ()
Root Schema : ErrorResponseData
Type: object
Show Source
Nested Schema : details
Type: object
Back to Top