Skip to navigation
APIsStudy ResourcesStudies

Update a study

Updates the specified study by setting the values of the parameters passed. Omitted properties are left untouched. The study must not be archived or canceled.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

studyIdstringRequiredformat: "^sdy_[a-zA-Z0-9]{10,22}$"
The unique identifier of the study.

Headers

X-Studies-Api-VersionstringOptional

Request

The study attributes to change.
namestringOptional1-255 characters
The name of the study.
project_idstring or nullOptionalformat: "^pjt_[a-zA-Z0-9]{10,22}$"

The project of the study. Must belong to your team. Send null to detach the study from its project.

owner_idstringOptionalformat: "^usr_[a-zA-Z0-9]{10,22}$"
Unique identifier for a user.
teamlist of objectsOptional

The team of the study, replacing the current membership entirely. May not include the author or owner. Send an empty array to remove every team member; null is rejected.

metadatamap from strings to any or nullOptional

The metadata to be associated to the study, merged into the existing metadata. Set an individual value to null to delete that key. A null object is accepted but changes nothing.

started_ondateOptional

Calendar date with no time or offset component, in ISO-8601 form.

Response headers

X-RateLimit-LimitintegerOptional
The number of requests permitted in the current rate limit window.
X-RateLimit-RemainingintegerOptional

The number of requests still available in the current rate limit window. When several limits apply, this reflects the per-API-key limit, so a request can be rejected while this value is above zero.

X-RateLimit-ResetintegerOptional
The number of seconds until the current rate limit window resets.

Response

The updated study.
idstringformat: "^sdy_[a-zA-Z0-9]{10,22}$"
Unique identifier for a study.
namestring<=255 characters
The name of the study.
codestring or null<=255 characters
The code of the study.
study_code_idstring or nullformat: "^sdc_[a-zA-Z0-9]{10,22}$"
The unique identifier of the study code template.
typeenum

Whether the study is run in-house or by an external partner. The all value accepted by some filters is not a valid study type and is never returned.

Allowed values:
statusenum
Review status of a study.
Allowed values:
descriptionstring or null
The description of the study.
timezonestring or null
The timezone of the study, as an IANA timezone identifier.
metadatamap from strings to any or null
The metadata associated to the study.
authorobject or null
The author of the study.
ownerobject or null
The owner of the study.
projectobject or null
The project of the study.
started_ondate

Calendar date with no time or offset component, in ISO-8601 form.

tracking_day_baseinteger or null
The day number assigned to the study's start date, from which all subsequent tracking days are counted.
completed_atdatetime or null
The completed timestamp of the study.
canceled_atdatetime or null
The canceled timestamp of the study.
created_atdatetime

UTC timestamp with microsecond precision, always suffixed with Z, in the form yyyy-MM-ddTHH:mm:ss.SSSSSSZ.

updated_atdatetime

UTC timestamp with microsecond precision, always suffixed with Z, in the form yyyy-MM-ddTHH:mm:ss.SSSSSSZ.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error