# Change your calendar settings

Changes some of the caller's calendar preferences - calendarId, workDayStartMinute, workDayEndMinute, defaultDurationMinutes, mirrorTaskDueTimes, onTaskCompleted (cancel | mark_done | keep) and reminderMinutes (0, 10, 30 or 60). A field the body omits is left as it was.

Access class: `workspace`.

## Endpoint

`PATCH /v1/me/calendar`

## Request body

Content type: `application/json`.

```json
{
  "body": {
    "calendarId": "",
    "defaultDurationMinutes": 1,
    "mirrorTaskDueTimes": true,
    "onTaskCompleted": "string",
    "reminderMinutes": 1,
    "workDayEndMinute": 1,
    "workDayStartMinute": 1
  },
  "params": {},
  "query": {}
}
```

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "calendarId": "",
    "defaultDurationMinutes": 1.5,
    "mirrorTaskDueTimes": true,
    "onTaskCompleted": "string",
    "reminderMinutes": 1.5,
    "stored": true,
    "updatedAt": "string",
    "workDayEndMinute": 1.5,
    "workDayStartMinute": 1.5
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
