v1.0
put
/ec-site-svc/rest/v1.0/organizations/{id}
Updates an organization by ID.
Request
Path Parameters
-
id(required): string
ID of an organization.Example:
C36A3197FDEE433FB5547EE83DE99E4B
Supported Media Types
- application/json
Root Schema : ORGANIZATION_MODEL_TITLE
Type:
objectTitle:
ORGANIZATION_MODEL_TITLEORGANIZATION_MODEL_DESC
Show Source
-
modes(required): object
ModeDto
Title:
ModeDtoRepresents a mode assignment for an entity. -
orgAddressesDetails(required): object
EntityAddressAssociationDto
Title:
EntityAddressAssociationDtoRepresents an address linked to an entity. -
organization(required): object
ORGANIZATION_DTO_TITLE
Title:
ORGANIZATION_DTO_TITLEORGANIZATION_DTO_DESC -
properties: object
PROPERTY_DTO_TITLE
Title:
PROPERTY_DTO_TITLEPROPERTY_DTO_DESC
Nested Schema : ModeDto
Type:
objectTitle:
ModeDtoRepresents a mode assignment for an entity.
Show Source
-
comment: string
Title:
CommentMinimum Length:0Maximum Length:2048Additional comment captured for the audited update.Example:Association adjusted after data reconciliation. -
entityId: string
(uuid)
Title:
Entity IDIdentifier of the associated entity. -
entityType: string
Title:
Entity TypeMinimum Length:0Maximum Length:50Type of entity tied to the mode.Example:Contact -
id: string
(uuid)
Title:
Mode IDUnique identifier for the mode assignment. -
mode: string
(uuid)
Title:
ModeIdentifier of the mode. -
modeCodeValue: string
Title:
Mode Code ValueMinimum Length:0Maximum Length:50Display value for the mode.Example:Operational -
reason: string
Title:
ReasonMinimum Length:0Maximum Length:255Reason provided for the audited update.Example:Protocol update requested by study operations. -
versionStart: string
(date-time)
Example:
[
"test"
]Nested Schema : EntityAddressAssociationDto
Type:
objectTitle:
EntityAddressAssociationDtoRepresents an address linked to an entity.
Show Source
-
addressCity: string
-
addressPostalcode(required): string
Title:
Postal CodeMinimum Length:0Maximum Length:20Postal code for the address.Example:80202 -
addressProperties: object
PROPERTY_DTO_TITLE
Title:
PROPERTY_DTO_TITLEPROPERTY_DTO_DESC -
addressStateOrProvOrCounty: string
(uuid)
-
addressStateOrProvOrCountyCodeValue: string
-
addressStreet1: string
-
addressStreet2: string
-
addressType: string
(uuid)
Title:
Address TypeIdentifier for the address type. -
addressTypeCodeValue: string
Title:
Address Type CodeMinimum Length:0Maximum Length:150Display value for the address type.Example:Primary -
comment: string
Title:
CommentMinimum Length:0Maximum Length:2048Additional comment captured for the audited update.Example:Association adjusted after data reconciliation. -
country: string
(uuid)
Title:
Country IDIdentifier for the country. -
countryCodeValue: string
Title:
Country CodeMinimum Length:0Maximum Length:150Display value for the country code.Example:USA -
entityId: string
(uuid)
Title:
Entity IDIdentifier of the entity owning the address. -
entityType: string
Title:
Entity TypeMinimum Length:0Maximum Length:50Type of entity for the address.Example:Contact -
id: string
(uuid)
Title:
Address Association IDUnique identifier for the entity address association. -
mainPrimary: boolean
Title:
Main Primary FlagIndicates if this is the main primary address.Example:true -
reason: string
Title:
ReasonMinimum Length:0Maximum Length:255Reason provided for the audited update.Example:Protocol update requested by study operations. -
versionStart: string
(date-time)
Example:
[
{
"id":"C36A3197FDEE433FB5547EE83DE99E4B"
}
]Nested Schema : ORGANIZATION_DTO_TITLE
Type:
objectTitle:
ORGANIZATION_DTO_TITLEORGANIZATION_DTO_DESC
Show Source
-
categoryType: string
(uuid)
-
categoryTypeCodeValue: string
Title:
ORGANIZATION_DTO_CATEGORY_TYPE_CODE_VALUE_TITLEMinimum Length:0Maximum Length:50ORGANIZATION_DTO_CATEGORY_TYPE_CODE_VALUE_DESCExample:CATEGORY_CODE -
comment: string
Title:
CommentMinimum Length:0Maximum Length:2048Additional comment captured for the audited update.Example:Association adjusted after data reconciliation. -
id: string
(uuid)
-
msa: string
Title:
ORGANIZATION_DTO_MSA_TITLEMinimum Length:0Maximum Length:1ORGANIZATION_DTO_MSA_DESCExample:Y -
msaEnd: string
(date-time)
Title:
ORGANIZATION_DTO_MSA_END_TITLEORGANIZATION_DTO_MSA_END_DESCExample:2026-01-01T00:00:00Z -
msaStart: string
(date-time)
Title:
ORGANIZATION_DTO_MSA_START_TITLEORGANIZATION_DTO_MSA_START_DESCExample:2025-01-01T00:00:00Z -
name(required): string
Minimum Length:
0Maximum Length:500Example:Sample Name -
orgId: string
Title:
ORGANIZATION_DTO_ORG_ID_TITLEMinimum Length:0Maximum Length:50ORGANIZATION_DTO_ORG_ID_DESCExample:ORG-12345 -
orgType: string
(uuid)
-
orgTypeCodeValue: string
Title:
ORGANIZATION_DTO_ORG_TYPE_CODE_VALUE_TITLEMinimum Length:0Maximum Length:50ORGANIZATION_DTO_ORG_TYPE_CODE_VALUE_DESCExample:ORG_TYPE_CODE -
reason: string
Title:
ReasonMinimum Length:0Maximum Length:255Reason provided for the audited update.Example:Protocol update requested by study operations. -
status: string
(uuid)
-
statusCodeValue: string
Title:
ORGANIZATION_DTO_STATUS_CODE_VALUE_TITLEMinimum Length:0Maximum Length:50ORGANIZATION_DTO_STATUS_CODE_VALUE_DESCExample:Active -
subType: string
(uuid)
-
subTypeCodeValue: string
Title:
ORGANIZATION_DTO_SUB_TYPE_CODE_VALUE_TITLEMinimum Length:0Maximum Length:50ORGANIZATION_DTO_SUB_TYPE_CODE_VALUE_DESCExample:SUB_TYPE -
taxId: string
Title:
ORGANIZATION_DTO_TAX_ID_TITLEMinimum Length:0Maximum Length:50ORGANIZATION_DTO_TAX_ID_DESCExample:TAX-12345 -
timezone: string
Title:
ORGANIZATION_DTO_TIMEZONE_TITLEORGANIZATION_DTO_TIMEZONE_DESCExample:America/New_York -
vatId: string
Title:
ORGANIZATION_DTO_VAT_ID_TITLEMinimum Length:0Maximum Length:50ORGANIZATION_DTO_VAT_ID_DESCExample:VAT-67890 -
versionStart: string
(date-time)
Example:
2026-01-15T10:30:00Z -
webUrl: string
Title:
ORGANIZATION_DTO_WEB_URL_TITLEMinimum Length:0Maximum Length:255Pattern:[(http(s)?):\/\/(www\.)?a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&//=]*)ORGANIZATION_DTO_WEB_URL_DESCExample:https://acme.example.com
Example:
{
"id":"B1B8327AFAA6412287106192AB5984EF",
"name":"Acme CRO"
}Nested Schema : PROPERTY_DTO_TITLE
Type:
objectTitle:
PROPERTY_DTO_TITLEPROPERTY_DTO_DESC
Show Source
-
comment: string
Title:
CommentMinimum Length:0Maximum Length:2048Additional comment captured for the audited update.Example:Association adjusted after data reconciliation. -
entityId: string
ENTITY_ID_DESCExample:
2A5E92F1C2D54DDA9F1C0A9E7B3C2D1A -
entityType: string
Title:
PROPERTY_DTO_ENTITY_TYPE_TITLEMinimum Length:0Maximum Length:50PROPERTY_DTO_ENTITY_TYPE_DESCExample:INSTITUTION -
propertyName(required): string
Title:
PROPERTY_DTO_NAME_TITLEMinimum Length:0Maximum Length:100PROPERTY_DTO_NAME_DESCExample:LabId -
propertyValue(required): string
Title:
PROPERTY_DTO_VALUE_TITLEMinimum Length:0Maximum Length:500PROPERTY_DTO_VALUE_DESCExample:2A5E92F1C2D54DDA9F1C0A9E7B3C2D1A -
reason: string
Title:
ReasonMinimum Length:0Maximum Length:255Reason provided for the audited update.Example:Protocol update requested by study operations.
Example:
[
{
"id":"C36A3197FDEE433FB5547EE83DE99E4B"
}
]Nested Schema : PROPERTY_DTO_TITLE
Type:
objectTitle:
PROPERTY_DTO_TITLEPROPERTY_DTO_DESC
Show Source
-
comment: string
Title:
CommentMinimum Length:0Maximum Length:2048Additional comment captured for the audited update.Example:Association adjusted after data reconciliation. -
entityId: string
ENTITY_ID_DESCExample:
2A5E92F1C2D54DDA9F1C0A9E7B3C2D1A -
entityType: string
Title:
PROPERTY_DTO_ENTITY_TYPE_TITLEMinimum Length:0Maximum Length:50PROPERTY_DTO_ENTITY_TYPE_DESCExample:INSTITUTION -
propertyName(required): string
Title:
PROPERTY_DTO_NAME_TITLEMinimum Length:0Maximum Length:100PROPERTY_DTO_NAME_DESCExample:LabId -
propertyValue(required): string
Title:
PROPERTY_DTO_VALUE_TITLEMinimum Length:0Maximum Length:500PROPERTY_DTO_VALUE_DESCExample:2A5E92F1C2D54DDA9F1C0A9E7B3C2D1A -
reason: string
Title:
ReasonMinimum Length:0Maximum Length:255Reason provided for the audited update.Example:Protocol update requested by study operations.
Examples
Back to Top
Response
Supported Media Types
- application/json
204 Response
Successful operation.
Root Schema : Organizations
Type:
Show Source
object-
categoryType: string
(uuid)
Represents category type for this record.
-
categoryTypeCodeValue: string
Represents category type code value for this record.Example:
SITE -
comment: string
Minimum Length:
0Maximum Length:2048Additional user comment about the latest change.Example:Association adjusted after data reconciliation. -
id: string
(uuid)
Unique identifier for this record.
-
msa: string
Minimum Length:
0Maximum Length:5Represents msa for this record.Example:Sample Value -
msaEnd: string
(date-time)
Represents msa end for this record.Example:
2026-03-16T12:00:00Z -
msaStart: string
(date-time)
Represents msa start for this record.Example:
2026-03-16T12:00:00Z -
name(required): string
Minimum Length:
0Maximum Length:500Name value for this record.Example:Sample Name -
orgId(required): string
Minimum Length:
0Maximum Length:50Represents org id for this record.Example:SITE-001 -
orgType(required): string
(uuid)
Represents org type for this record.
-
orgTypeCodeValue: string
Represents org type code value for this record.Example:
SITE -
reason: string
Minimum Length:
0Maximum Length:255Reason for the latest change made to this record.Example:Protocol update requested by study operations. -
status(required): string
(uuid)
Represents status for this record.
-
statusCodeValue: string
Display value for the status code.Example:
ACTIVE -
studyAgnostic(required): string
Represents study agnostic for this record.Example:
N -
studyId(required): string
Identifier of the related study.Example:
C36A3197FDEE433FB5547EE83DE99E4B -
subType: string
(uuid)
Represents sub type for this record.
-
subTypeCodeValue: string
Represents sub type code value for this record.Example:
SITE -
taxId: string
Minimum Length:
0Maximum Length:50Represents tax id for this record.Example:Sample Value -
timezone: string
Represents timezone for this record.Example:
UTC -
vatId: string
Minimum Length:
0Maximum Length:50Represents vat id for this record.Example:Sample Value -
versionStart: string
(date-time)
Timestamp when this version became active.Example:
2026-03-16T12:00:00Z -
webUrl: string
Minimum Length:
0Maximum Length:255Pattern:[(http(s)?):\/\/(www\.)?a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&//=]*)Represents web url for this record.Example:https://example.org
Examples
400 Response
Returned when one or more path parameters, query parameters, or request-body values fail endpoint validation.
Root Schema : SDFResponse
Type:
objectTitle:
SDFResponseWrapper for service responses containing result or error data.
Show Source
-
errorData: object
ErrorResponseData
-
result: object
result
The result object for successful requests. Type depends on the API operation.
-
status: string
Status of the response, either 'success' or an error indication.Example:
success
Nested Schema : result
Type:
objectThe result object for successful requests. Type depends on the API operation.
Example:
{
"hasMore":"true",
"totalResults":5,
"count":5,
"data":[
]
}Nested Schema : details
Type:
objectExamples