[Deprecated]: V1.0
put
/ec-dc-svc/rest/v1.0/studies/{studyId}/{mode}/subjects/{subjectId}/randomizationnumber/{randNumber}
Deprecated: Updates randomization number when called by ORS service.
Request
Path Parameters
-
mode(required): string
Mode of the study. Accepts test, active, or training.
-
randNumber(required): string
RandomNumber to be updated.
-
studyId(required): string
ID of the study to which the subject belongs.
-
subjectId(required): string(uuid)
ID of the subject for whom you want to update details.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
RandomNumber is updated successfully.
Root Schema : schema
Type:
Show Source
array-
Array of:
object Subject1
Comprehensive subject details including identity, site, study, demographic and state details, with example showing all fields.
Nested Schema : Subject1
Type:
objectComprehensive subject details including identity, site, study, demographic and state details, with example showing all fields.
Show Source
-
canBeCompleted: boolean
Indicates if the subject can be completed (UI-only transient flag).Example:
true -
canBeReplaced: boolean
Indicates if the subject randomization can be replaced (UI-only transient flag).Example:
false -
canBeUndoWithdrawn: boolean
Indicates if the subject's withdrawal can be undone (UI-only transient flag).Example:
true -
comment: string
Minimum Length:
0Maximum Length:2048Comment regarding the last change made to the entity.Example:Imported via migration tool. -
description: string
Minimum Length:
0Maximum Length:500Description of the subject record.Example:Screened subject record -
dob: string
(date-time)
Date of birth of the subject.
-
enrollmentFailure: string
Minimum Length:
0Maximum Length:255Reason for enrollment failure (if the subject is not enrolled).Example:Consent Required -
enrollmentOverride: string
Minimum Length:
0Maximum Length:255Administrative override details for subject enrollment, if any.Example:Subject enrollment overidden -
freezedStatus: string
Frozen status of the record can have values NOT_APPLICABLE, FROZEN.Example:
FROZEN -
fromStudyId: string
(uuid)
Originating study id for transferred subjects UUID, 32-character uppercase hexadecimal string.
-
gender: string
Minimum Length:
0Maximum Length:10Subject gender: typically 'male', 'female', or 'other'.Example:male -
hasLockData: boolean
Indicates if any data is locked for this subject (boolean, transient).Example:
false -
id: string
(uuid)
Subject unique identifier (UUID, 32-character uppercase hexadecimal string) .
-
informedConsentDate: string
(date-time)
Date the subject provided informed consent.
-
lastSigned: string
The timestamp or user who last signed the subject data, if transiently tracked.Example:
2025-10-15T08:00:00.000Z -
lockedDateTime: string
(date-time)
When this subject was locked, if at all (ISO date-time string).Example:
2025-10-18T11:05:00Z -
lockedInStudyVersion: string
The study version string when the subject was locked.Example:
1.0.0.0 -
lockedStatus: string
Current locked status of the subject record from UI perspective.Values can be LOCKED, NEVER_LOCAKED, UNLOCKED, NOT_APPLICABLEExample:
LOCKED -
mhealthSubjectId: string
(uuid)
Unique Identifier (UUID, 32-character uppercase hexadecimal string) of the subject in mHealth system.
-
operationType: string
Minimum Length:
1Maximum Length:16Operation type on the record, can have values CREATED, MODIFIED or REMOVEDExample:REMOVED -
previousSubjectNumber: string
The previous subject number, for audit/tracking purposes (if the subject number changed).Example:
SUBJ-0177 -
randomizationNumber: string
The randomization number assigned to the subject.Example:
RAND-00235 -
reason: string
Minimum Length:
0Maximum Length:255Reason for the entity creation or latest modification.Example:Initial import. -
replaceRand: string
Indicates if subject's randomization was replaced (Y/N).Example:
Y -
reScreenEventInstanceNum: number
Number of times the subject was re-screened (transient, computed on the fly).Example:
2 -
screenFailureComment: string
Extended comment about screen failure.Example:
comment for screen failure -
screenFailureDate: string
(date-time)
The date the subject failed screening, if applicable.
-
screeningFailure: string
Minimum Length:
0Maximum Length:255Reason for subject screen failure, if applicable.Example:Lost to follow up -
sdvSelectionStatus: string
Source data verification selection status for the subject it can be NOT_SELECTED, INITIALCOUNT_SELECTED, POST_INITIALCOUNT_SELECTED.Example:
NOT_SELECTED -
signedStatus: string
Signed status for workflow, the acceptable values are: NEVER_SIGNED, SIGNED, UNSIGNED, NEVER_SIGNED.Example:
SIGNED -
siteId: string
Unique identifier (UUID, 32-character uppercase hexadecimal string) representing the clinical site.Example:
BEEFAABBCCDDEEDDFF00112233445566 -
state(required): string
Minimum Length:
0Maximum Length:100Lifecycle state of the subject.The state can be New, Active, Screening_Initiated, Screen_Failed, Withdrawn, Auto_Screen_Failed, Complete or Enrolled.Example:Screened -
stateDate: string
(date-time)
Timestamp when the 'state' was updated.Example:
2025-10-01T09:00:01Z -
studyCompletionDate: string
(date-time)
Date the subject completed the study.Example:
2025-10-01T09:00:01Z -
studyVersion: string
String representing the version of the study configuration or protocol. Helps track changes in form or study design.Example:
1.0.0.0 -
subjectNumber(required): string
Minimum Length:
0Maximum Length:500Unique subject Number representing the patient/participant enrolled in the study.Example:SUBJ-0199 -
subjectSDVUpdated: boolean
Indicates if the subject's Source Data Verification has been updated.Example:
true -
subjNumSiteOrgId: string
Organization/site identifier for subject number context.Example:
AABBCC11223344556677 -
totalAllowedRescreenLimit: string
The maximum number of rescreens allowed for the subject (transient, calculated).Example:
3 -
unblindComment: string
Further comment on unblinding.Example:
required comment -
unblindDate: string
(date-time)
Date/time the subject was unblinded.Example:
2025-10-01T09:00:01Z -
unblindReason: string
Reason for subject being unblinded.Example:
Reason -
verifiedStatus: string
Verified status for review workflow,the acceptable values are: NEVER_VEIFIED, VERIFIED, UNVERIFIED, NOT_APPLICABLE.Example:
VERIFIED -
versionStart: string
(date-time)
The timestamp marking the beginning of the validity period for this record version within the system.Example:
2025-10-16T14:30:31.892Z -
withdrawalComment: string
Comment on withdrawal.Example:
comment for withdrawal -
withdrawalDate: string
(date-time)
Date the subject was withdrawn from the study.Example:
2025-10-01T09:00:01Z -
withdrawalReason: string
Reason for withdrawal.Example:
reason for withdrawal
400 Response
Bad request.
Root Schema : Response
Type:
Show Source
object-
allowedMethods: array
allowedMethods
Unique Items Required:
true -
closed: boolean
-
cookies: object
cookies
Additional Properties Allowed: NewCookie
-
date: string
(date-time)
-
entity: object
entity
-
entityTag: object
EntityTag
-
headers: object
headers
Additional Properties Allowed: additionalProperties
-
language: object
language
-
lastModified: string
(date-time)
-
length: integer
(int32)
-
links: array
links
Unique Items Required:
true -
location: string
(uri)
-
mediaType: object
MediaType
-
metadata: object
metadata
Additional Properties Allowed: additionalProperties
-
status: integer
(int32)
-
statusInfo: object
StatusType
-
stringHeaders: object
stringHeaders
Additional Properties Allowed: additionalProperties
Nested Schema : entity
Type:
objectNested Schema : language
Type:
Show Source
object-
country: string
-
displayCountry: string
-
displayLanguage: string
-
displayName: string
-
displayScript: string
-
displayVariant: string
-
extensionKeys: array
extensionKeys
Unique Items Required:
true -
iso3Country: string
-
iso3Language: string
-
language: string
-
script: string
-
unicodeLocaleAttributes: array
unicodeLocaleAttributes
Unique Items Required:
true -
unicodeLocaleKeys: array
unicodeLocaleKeys
Unique Items Required:
true -
variant: string
Nested Schema : MediaType
Type:
Show Source
object-
parameters: object
parameters
Additional Properties Allowed: additionalProperties
-
subtype: string
-
type: string
-
wildcardSubtype: boolean
-
wildcardType: boolean
Nested Schema : StatusType
Type:
Show Source
object-
family: string
Allowed Values:
[ "INFORMATIONAL", "SUCCESSFUL", "REDIRECTION", "CLIENT_ERROR", "SERVER_ERROR", "OTHER" ] -
reasonPhrase: string
-
statusCode: integer
(int32)
Nested Schema : NewCookie
Type:
Show Source
object-
comment: string
-
domain: string
-
expiry: string
(date-time)
-
httpOnly: boolean
-
maxAge: integer
(int32)
-
name: string
-
path: string
-
sameSite: string
Allowed Values:
[ "NONE", "LAX", "STRICT" ] -
secure: boolean
-
value: string
-
version: integer
(int32)
Nested Schema : items
Type:
objectNested Schema : Link
Type:
Show Source
object-
params: object
params
Additional Properties Allowed: additionalProperties
-
rel: string
-
rels: array
rels
-
title: string
-
type: string
-
uri: string
(uri)
-
uriBuilder: object
UriBuilder
Nested Schema : UriBuilder
Type:
objectNested Schema : items
Type:
object