Define the visit schedule
Make a POST request to define the schedule for an already created visit.
Note:
- To run these Oracle Clinical One Platform API calls, you need to include an authentication token. For instructions on how to generate your authentication token, see Get a token for authentication and Use the token to make an API request.
- For every API call make sure you construct the URL using the correct server URL and path parameters values.
For the following API calls, you need the studyID
and
version
. These values are retrieved as part of a previous task, see Get study information.
To define the schedule for a visit, you need to have the visit already created and another
visit to schedule it from. See Create a visit and
make sure you save the visitId
associated to each.
Step 1: Create the request payload file
The JSON file below is an example of what the payload of a visit schedule should look like.
Note:
Replace thevisitId
with the actual ID value for the
visit to schedule this from. For example, if you are adding the Randomization visit
schedule from the Screening visit, then use the screening visit's ID.
{
"delay":
{
"days": 30,
"hours": 0
},
"delayWindow":
{
"before":
{
"days": 0,
"hours": 0
},
"after":
{
"days": 29,
"hours": 0
}
},
"outOfWindowHardStopEnforced": 0,
"outOfWindowVisitApprovalGranted": 0,
"projectedFromRefId": "visitId",
"branchId": null
}
Step 2: Add visit scheduled using payload file
Run the following cURL call to define the visit schedule, using the request payload file created on step 1:
curl -X POST "https://tenant.clinicalone.oraclecloud.com/ec-designer-svc/rest/v4.0/studies/{studyId}/versions/{version}/visits/{visitid}/schedule/{fromEventRefId}" -d "@RandomizationVisitSchedule.json"
For more information on how to build the payload and other parameters, see Create visit schedule.
View visit schedule
Given a visitId
, run the following command to get the visit schedule
information:
curl -X GET https://tenant.clinicalone.oraclecloud.com/ec-designer-svc/rest/v4.0/studies/{studyId}/versions/{version}/visits/{visitid}/schedule"
For more details on this API, like its parameters and response objects, see Get visit schedule.
Tip:
Browse for these and other related APIs under the Tasks section of this guide. If you see any deprecated endpoint, look for its newest version.