Beta

Create Schedule

POSThttps://api.youvico.com/api/projects/:id/schedules
Rate Limit
Tier 3
Project Role
OwnerManagerMember

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

idstringrequired
Project ID

Body

namestringrequired

1-255 characters

Schedule name

Example: Final review

descriptionstring

1-1000 characters

Schedule description

Example: Review the final cut

startDatestringrequired
Start date. YYYY-MM-DD

Example: 2026-05-31

startTimestring?required
Start time. HH:mm, null for an all-day schedule

Example: 09:00

endDatestring?required
End date. YYYY-MM-DD, null when it ends on the start date

Example: 2026-06-01

endTimestring?required
End time. HH:mm, or null

Example: 18:00

colorstringrequired
Schedule color

Possible values: NONEREDORANGEYELLOWGREENBLUEPURPLEPINKGRAY

Example: BLUE

Note

The dates and times must satisfy all of the following:

  • If startTime is null, endTime must also be null.
  • If startTime and endDate are set, endTime must also be set.
  • endDate must be later than startDate. For a schedule that ends on its start date, send endDate as null and set only endTime.
  • The end must be later than the start.

Response

Returns 201 Created.

dataobject
Created schedule
data.idstring
Schedule ID

Example: 5f2c8a1e-3b4d-4e6f-9a7b-1c2d3e4f5a6b