Create Schedule
POST
https://api.youvico.com/api/projects/:id/schedules- Rate Limit
- Tier 3
- Scope
- schedules:write
Creates a project schedule.
Example
curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/schedules' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "name": "Final review", "description": "Review the final cut", "startDate": "2026-05-31", "startTime": "09:00", "endDate": "2026-06-01", "endTime": "18:00", "color": "BLUE" }'
{
"data": {
"id": "5f2c8a1e-3b4d-4e6f-9a7b-1c2d3e4f5a6b"
}
}
Request
curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/schedules' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "Final review",
"description": "Review the final cut",
"startDate": "2026-05-31",
"startTime": "09:00",
"endDate": "2026-06-01",
"endTime": "18:00",
"color": "BLUE"
}'
Response201 Created
{
"data": {
"id": "5f2c8a1e-3b4d-4e6f-9a7b-1c2d3e4f5a6b"
}
}
Request
Path
idstringrequiredProject ID
Body
namestringrequired1-255 characters
Schedule name
Example: Final review
descriptionstring1-1000 characters
Schedule description
Example: Review the final cut
startDatestringrequiredStart date. YYYY-MM-DD
Example: 2026-05-31
startTimestring?requiredStart time. HH:mm, null for an all-day schedule
Example: 09:00
endDatestring?requiredEnd date. YYYY-MM-DD, null when it ends on the start date
Example: 2026-06-01
endTimestring?requiredEnd time. HH:mm, or null
Example: 18:00
colorstringrequiredSchedule color
Possible values: NONEREDORANGEYELLOWGREENBLUEPURPLEPINKGRAY
Example: BLUE
Note
The dates and times must satisfy all of the following:
- If
startTimeisnull,endTimemust also benull. - If
startTimeandendDateare set,endTimemust also be set. endDatemust be later thanstartDate. For a schedule that ends on its start date, sendendDateasnulland set onlyendTime.- The end must be later than the start.
Response
Returns 201 Created.
dataobjectCreated schedule
data.idstringSchedule ID
Example: 5f2c8a1e-3b4d-4e6f-9a7b-1c2d3e4f5a6b