Jump to

• Request
• Response

V1.0

delete

/ec-dc-svc/rest/v1/studies/{studyId}/{mode}/subjectsettings

Removes subject settings. This endpoint deletes subject settings for the given study. Provide an array of subject setting objects to be removed.

Request

Path Parameters

• mode(required): string
  Mode of the study, accepts: test, active, or training.

  Example:

  test

• studyId(required): string(uuid)
  Unique identifier (UUID, 32-character uppercase hexadecimal string) representing the study.

  Example:

  7E355221FB2B4B698E4C37952778A8E0

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Request payload containing a list of subject settings to create or update.

Show Source

• subjectSettings: array subjectSettings
  List of subject setting objects, each including unique identifier, versioning, key, value, and audit details.

{
    "type":"object",
    "properties":{
        "subjectSettings":{
            "type":"array",
            "description":"List of subject setting objects, each including unique identifier, versioning, key, value, and audit details.",
            "items":{
                "$ref":"#/components/schemas/SubjectSetting"
            }
        }
    },
    "description":"Request payload containing a list of subject settings to create or update."
}

Nested Schema : subjectSettings

Type: array

List of subject setting objects, each including unique identifier, versioning, key, value, and audit details.

Show Source

• Array of: object SubjectSetting
  Entity representing a single subject setting. Contains business key, value, version, and audit info. Used in requests and responses.

{
    "type":"array",
    "description":"List of subject setting objects, each including unique identifier, versioning, key, value, and audit details.",
    "items":{
        "$ref":"#/components/schemas/SubjectSetting"
    }
}

Nested Schema : SubjectSetting

Type: object

Entity representing a single subject setting. Contains business key, value, version, and audit info. Used in requests and responses.

Show Source

• attributeKey(required): string
  Key of the subject setting attribute. Possible values:
  

  • sequential_across_study_or_site
  • limit_screened_subjects
  • withdraw_subject_codebreak
  • limit_randomize_subjects
  • user_enters_screening_visit_date
  • user_edits_screening_visit_date
  • user_enters_randomization_visit_date
  • user_edits_randomization_visit_date
  • user_enters_dispensation_visit_date
  • user_edits_dispensation_visit_date
  • user_enters_non_dispensation_visit_date
  • user_edits_non_dispensation_visit_date
  • user_enters_optional_visit_date
  • user_edits_optional_visit_date
  • user_enters_withdraw_visit_date
  • user_edits_withdraw_visit_date
  • randomization_visit_date_additional_setting
  • dispensation_visit_date_additional_setting
  • can_dispensation_visit_be_skipped
  • can_non_dispensation_visit_be_skipped
  • separate_siteid_and_subjectid_hyphen
  • limit_study_status
  • limit_site_scr
  • limit_site_rand
  • limit_site_alerts
  • limit_site_status
  • limit_country_scr
  • limit_country_rand
  • limit_country_alerts
  • limit_country_status
  • padding_for_subject_id
  • max_randomize_subject
  • subject_alerts
  • max_screened_subject
  • subject_addition_allowed
  • subject_number_selection_allowed
  • subject_number_format
  • retry_partial_sdv_selection
  • notify_unsched_visit_failure_only
  • notify_screening_failure_only
  • notify_optional_visit_failure_only
  • notify_nondisp_visit_failure_only
  • notify_randomization_failure_only
  • notify_dispensation_failure_only
  • notify_subjcomplete_visit_failure_only
  • show_visit_window
  • notify_first_screened_in_study
  • notify_first_screened_at_site
  • notify_first_randomized_in_study
  • notify_first_randomized_at_site
  • allow_withdrawal_before_enrollment
  • allow_display_signature_elements
  • replace_subject_number_rand_number
  • code_data_for_new_and_screen_failed_subjects
  • blind_rand_number_enabled
  • replace_randomisation_enabled
  • replace_randomisation_prefix
  • replace_randomisation_max_limit
  • allow_rescreening
  • number_of_rescreen_allowed
  • lock_screen_data_on_failure
  • user_enters_rescreening_visit_date
  • user_edits_rescreening_visit_date
  • notify_rescreening_failure_only
  • replace_subject_number_enabled
  • assign_subject_number
  • allow_screen_fail_before_screened
  • limit_country_AF_status
  • limit_country_AF_scr
  • limit_country_AF_alerts
  • limit_country_AF_name
  • limit_country_AF_rand
  • limit_country_DZ_alerts
  • limit_country_DZ_rand
  • limit_country_DZ_status
  • limit_country_DZ_name
  • limit_country_DZ_scr
  • minimum_subject_number
  • allow_withdrawal_for_screen_failed
  • allow_completion_for_screen_failed
  • enable_assign_subject_number

  Example: assign_subject_number
• attributeValue(required): string
  String value assigned to this subject setting attribute.

  Example: YES
• comment: string
  Minimum Length: 0

  Maximum Length: 2048

  Comment regarding the last change made to the entity.

  Example: Imported via migration tool.
• id: string
  Unique identifier (UUID, 32-character uppercase hexadecimal string) for the subject setting.

  Example: 9C67E72C1F2A4BE997B5C0F7A3C91E45
• operationType: string
  Minimum Length: 1

  Maximum Length: 16

  Operation type on the record, can have values CREATED, MODIFIED or REMOVED

  Example: REMOVED
• reason: string
  Minimum Length: 0

  Maximum Length: 255

  Reason for the entity creation or latest modification.

  Example: Initial import.
• versionStart: string (date-time)
  The timestamp marking the beginning of the validity period for this record version within the system.

  Example: 2023-01-01T00:00:00Z

{
    "required":[
        "attributeKey",
        "attributeValue"
    ],
    "type":"object",
    "properties":{
        "reason":{
            "maxLength":255,
            "minLength":0,
            "type":"string",
            "description":"Reason for the entity creation or latest modification.",
            "example":"Initial import."
        },
        "comment":{
            "maxLength":2048,
            "minLength":0,
            "type":"string",
            "description":"Comment regarding the last change made to the entity.",
            "example":"Imported via migration tool."
        },
        "operationType":{
            "maxLength":16,
            "minLength":1,
            "type":"string",
            "description":"Operation type on the record, can have values CREATED, MODIFIED or REMOVED",
            "example":"REMOVED"
        },
        "id":{
            "type":"string",
            "description":"Unique identifier (UUID, 32-character uppercase hexadecimal string) for the subject setting.",
            "example":"9C67E72C1F2A4BE997B5C0F7A3C91E45"
        },
        "versionStart":{
            "type":"string",
            "description":"The timestamp marking the beginning of the validity period for this record version within the system.",
            "format":"date-time",
            "example":"2023-01-01T00:00:00Z"
        },
        "attributeKey":{
            "type":"string",
            "description":"<b>Key of the subject setting attribute. Possible values:</b><br/><ul><li>sequential_across_study_or_site</li><li>limit_screened_subjects</li><li>withdraw_subject_codebreak</li><li>limit_randomize_subjects</li><li>user_enters_screening_visit_date</li><li>user_edits_screening_visit_date</li><li>user_enters_randomization_visit_date</li><li>user_edits_randomization_visit_date</li><li>user_enters_dispensation_visit_date</li><li>user_edits_dispensation_visit_date</li><li>user_enters_non_dispensation_visit_date</li><li>user_edits_non_dispensation_visit_date</li><li>user_enters_optional_visit_date</li><li>user_edits_optional_visit_date</li><li>user_enters_withdraw_visit_date</li><li>user_edits_withdraw_visit_date</li><li>randomization_visit_date_additional_setting</li><li>dispensation_visit_date_additional_setting</li><li>can_dispensation_visit_be_skipped</li><li>can_non_dispensation_visit_be_skipped</li><li>separate_siteid_and_subjectid_hyphen</li><li>limit_study_status</li><li>limit_site_scr</li><li>limit_site_rand</li><li>limit_site_alerts</li><li>limit_site_status</li><li>limit_country_scr</li><li>limit_country_rand</li><li>limit_country_alerts</li><li>limit_country_status</li><li>padding_for_subject_id</li><li>max_randomize_subject</li><li>subject_alerts</li><li>max_screened_subject</li><li>subject_addition_allowed</li><li>subject_number_selection_allowed</li><li>subject_number_format</li><li>retry_partial_sdv_selection</li><li>notify_unsched_visit_failure_only</li><li>notify_screening_failure_only</li><li>notify_optional_visit_failure_only</li><li>notify_nondisp_visit_failure_only</li><li>notify_randomization_failure_only</li><li>notify_dispensation_failure_only</li><li>notify_subjcomplete_visit_failure_only</li><li>show_visit_window</li><li>notify_first_screened_in_study</li><li>notify_first_screened_at_site</li><li>notify_first_randomized_in_study</li><li>notify_first_randomized_at_site</li><li>allow_withdrawal_before_enrollment</li><li>allow_display_signature_elements</li><li>replace_subject_number_rand_number</li><li>code_data_for_new_and_screen_failed_subjects</li><li>blind_rand_number_enabled</li><li>replace_randomisation_enabled</li><li>replace_randomisation_prefix</li><li>replace_randomisation_max_limit</li><li>allow_rescreening</li><li>number_of_rescreen_allowed</li><li>lock_screen_data_on_failure</li><li>user_enters_rescreening_visit_date</li><li>user_edits_rescreening_visit_date</li><li>notify_rescreening_failure_only</li><li>replace_subject_number_enabled</li><li>assign_subject_number</li><li>allow_screen_fail_before_screened</li><li>limit_country_AF_status</li><li>limit_country_AF_scr</li><li>limit_country_AF_alerts</li><li>limit_country_AF_name</li><li>limit_country_AF_rand</li><li>limit_country_DZ_alerts</li><li>limit_country_DZ_rand</li><li>limit_country_DZ_status</li><li>limit_country_DZ_name</li><li>limit_country_DZ_scr</li><li>minimum_subject_number</li><li>allow_withdrawal_for_screen_failed</li><li>allow_completion_for_screen_failed</li><li>enable_assign_subject_number</li></ul>",
            "example":"assign_subject_number"
        },
        "attributeValue":{
            "type":"string",
            "description":"String value assigned to this subject setting attribute.",
            "example":"YES"
        }
    },
    "description":"Entity representing a single subject setting. Contains business key, value, version, and audit info. Used in requests and responses."
}

Examples

Select an example DeleteRequest

Back to Top

Response

Supported Media Types

• application/json

204 Response

No content.

Examples

Select an example Delete Subject Settings Response

400 Response

Bad request.

Body ()

Root Schema : DcsResponse

Type: object

Show Source

• errorData: object ErrorResponseData
  Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
• result: object result
• status: string
• version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string"
        },
        "result":{
            "type":"object"
        },
        "version":{
            "type":"integer",
            "format":"int32",
            "writeOnly":true
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        }
    }
}

Nested Schema : ErrorResponseData

Type: object

Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.

Show Source

• details: object details
  Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.
• errorCode: string
  Application or business-specific error code representing the error type.

  Example: REPT_401
• errorMessage: string
  Human-readable error message describing the failure or issue.

  Example: Unauthorized: User does not have access to the requested resource

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Application or business-specific error code representing the error type.",
            "example":"REPT_401"
        },
        "errorMessage":{
            "type":"string",
            "description":"Human-readable error message describing the failure or issue.",
            "example":"Unauthorized: User does not have access to the requested resource"
        },
        "details":{
            "type":"object",
            "description":"Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.",
            "example":"User role is missing required permission REPORTING_VIEW. Field: userId"
        }
    },
    "description":"Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details."
}

Nested Schema : result

Type: object

Nested Schema : details

Type: object

Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.

Example:

User role is missing required permission REPORTING_VIEW. Field: userId

Back to Top