Skip to navigation

Update StudySchema

Update a study schema. Only the supplied fields are changed; studyType cannot be changed after creation.

ID generation

  • Changing idGenerationMode or prefix affects only studies created after this update; existing study IDs do not change.
  • When changing to AUTO_GENERATED_FROM_PREFIX, provide a non-empty, unique prefix. Numbering continues from the highest existing study ID that uses the prefix.
  • When changing to MANUAL, the prefix is cleared.

Restrictions

  • When provided, entryTemplateIds replaces all existing entry-template associations. It is supported only for CUSTOM study schemas. Provide at most 50 IDs.
  • isDesignApprovalRequired is supported for CUSTOM schemas and, when design review is enabled for the tenant, for CLINICAL and PRECLINICAL schemas. It is not supported for PROCESS_DEVELOPMENT or ASSAY_DEVELOPMENT schemas.
  • systemName can be changed only when warehouse table-name changes are enabled for the caller; otherwise, a request that changes it fails with a validation error. Supplying the schema’s exact current systemName always succeeds.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

study_schema_idstringRequired
ID of the StudySchema.

Request

This endpoint expects an object.
archiveReasonstringOptional

Why it is being archived. Required when archived is true, and not allowed when unarchiving.

archivedbooleanOptional

Set to true to archive or false to unarchive it. Archiving requires archiveReason.

descriptionstringOptional
Updated description. When provided, must be at most 1000 characters.
entryTemplateIdslist of stringsOptional
Replacement entry template IDs for this schema.
idGenerationModeenumOptional

Updated study ID generation mode. Changing this setting only affects studies created from now on; existing studies keep their IDs. When switching to AUTO_GENERATED_FROM_PREFIX, numbering continues from the highest existing ID that uses the prefix. When switching to MANUAL, the prefix is automatically cleared if no prefix value is provided.

Allowed values:
isDesignApprovalRequiredbooleanOptional
Updated design approval requirement.
namestringOptional

Updated user-facing name. When provided, must be non-empty after stripping whitespace, at most 255 characters, and unique within the organization.

prefixstringOptional
Updated ID prefix for this schema.
systemNamestringOptional

Updated SQL identifier for the warehouse table name. When provided, must match the pattern [a-z_][a-z0-9_$]*, cannot be a reserved table name, cannot start with ‘bnch$’, and must be unique within the organization. Changing it requires warehouse table-name changes to be enabled for the caller; otherwise the update fails with a validation error. Supplying the schema’s exact current system name always succeeds.

displayNamestringOptionalDeprecated
Deprecated. Use name instead.

Response

OK
__typenamestringOptional
archiveReasonstring or nullOptional
archivedbooleanOptional
createdAtstring or nullOptionalformat: "datetime"
creatorobjectOptional
descriptionstringOptional
A description of this study schema for documentation purposes.
entryTemplatesstringOptionalformat: "uri"
fieldDefinitionsstringOptionalformat: "uri"
idstringOptional
idGenerationModeenumOptional
How Study IDs are assigned for studies of this schema.
Allowed values:
isDesignApprovalRequiredbooleanOptional
modifiedAtstring or nullOptionalformat: "datetime"
namestringOptional
organizationobjectOptional
prefixstring or nullOptional
studyTypeenumOptional
Allowed values:

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error