Replace a business calendar Reference Published Oct 13, 2026 Replace a business calendar in Dynatrace with the AutomationEngine API by updating its title, dates, holidays, weekdays, and description.
PUT SaaS https://{your-environment-id}.apps.dynatrace.com/platform/automation/v1/business-calendars/{id}
Overview You update the business calendar identified by the id path parameter. The request body can include title, weekstart, holidays, validFrom, validTo, description, and weekdays, and the operation returns 200 on success.
Authentication To execute this request, you need a platform token or OAuth access token with automation:calendars:write scope. To learn how to obtain and use it, see Tokens and authentication .
Parameters Request body objects The BusinessCalendarUpdate object title string - Optional weekstart integer - Optional holidays Holiday []- Optional validFrom string - Optional validTo string - Optional description string - Optional weekdays Weekdays Names | Weekdays Values - Optional
The Holidays object The Holiday object title string - Required date string - Required
The Weekdays object
The WeekdaysNames object
The WeekdaysValues object Request body JSON model This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{
"title" : "string" ,
"weekstart" : 1 ,
"holidays" : [
{
"title" : "string" ,
"date" : "string"
}
] ,
"validFrom" : "string" ,
"validTo" : "string" ,
"description" : "string" ,
"weekdays" : [
"MO" ,
"TU" ,
"WE" ,
"TH" ,
"FR"
]
}
Response Response body objects The BusinessCalendarResponse object
The Holidays object The ModificationInfo object createdBy string - createdTime string - lastModifiedBy string - lastModifiedTime string -
The WeekdaysValues object
The WeekdaysNames object The ErrorDetails object errorCode string - errorRef string -
Response body JSON models {
"id" : "string" ,
"title" : "string" ,
"version" : 1 ,
"weekstart" : 1 ,
"holidays" : [
{
"title" : "string" ,
"date" : "string"
}
] ,
"validFrom" : "string" ,
"validTo" : "string" ,
"description" : "string" ,
"modificationInfo" : {
"createdBy" : "string" ,
"createdTime" : "string" ,
"lastModifiedBy" : "string" ,
"lastModifiedTime" : "string"
} ,
"weekdays" : [
1 ,
2 ,
3 ,
4 ,
5
] ,
"weekdaysNames" : [
"MO" ,
"TU" ,
"WE" ,
"TH" ,
"FR"
]
}
{
"error" : {
"message" : "string" ,
"code" : 1 ,
"details" : {
"errorCode" : "string" ,
"errorRef" : "string"
}
}
}