Try it free

Update a business calendar

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Update a business calendar in Dynatrace with the AutomationEngine API by changing its title, dates, holidays, weekdays, and description.

PATCHSaaShttps://{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

ParameterTypeDescriptionInRequired
idstring

A UUID string identifying this business calendar.

pathRequired
bodyBusinessCalendarUpdate-bodyRequired

Request body objects

The BusinessCalendarUpdate object

ElementTypeDescriptionRequired
titlestring-Optional
weekstartinteger-Optional
holidaysHoliday[]-Optional
validFromstring-Optional
validTostring-Optional
descriptionstring-Optional
weekdaysWeekdaysNames | WeekdaysValues-Optional

The Holidays object

The Holiday object

ElementTypeDescriptionRequired
titlestring-Required
datestring-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 codes

CodeTypeDescription
200BusinessCalendarResponse-
4XXErrorEnvelope-

Response body objects

The BusinessCalendarResponse object

ElementTypeDescription
idstring-
titlestring-
versioninteger-
weekstartinteger-
holidaysHoliday[]-
validFromstring-
validTostring-
descriptionstring-
modificationInfoModificationInfo-
weekdaysWeekdaysValues

The weekdays values

weekdaysNamesWeekdaysNames

The weekdays names

The Holidays object

The Holiday object

ElementTypeDescription
titlestring-
datestring-

The ModificationInfo object

ElementTypeDescription
createdBystring-
createdTimestring-
lastModifiedBystring-
lastModifiedTimestring-

The WeekdaysValues object

The WeekdaysNames object

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
messagestring-
codeinteger-
detailsErrorDetails-

The ErrorDetails object

ElementTypeDescription
errorCodestring-
errorRefstring-

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"
}
}
}
Related tags
Platform APIDynatrace Platform