> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Update out of office entry

> Updates one out-of-office entry for the connected user.

`calcom.updateOutOfOfficeEntry` updates one out-of-office entry for the connected user.

```ts automations/update-out-of-office-entry.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { calcom } from "automate.ax/calcom"

export default automation("Update out of office entry", () => {
  markSignificant(
    calcom.updateOutOfOfficeEntry({ oooId: 11, notes: "Conference" }),
  )
})
```

## Input

Pass these fields:

| Field      | Type                                                                    | Required | Description                                                                             |
| ---------- | ----------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------- |
| `oooId`    | `integer`                                                               | Yes      | Must be greater than 0.                                                                 |
| `start`    | `string (date-time)`                                                    | No       | The start date and time of the out of office period in ISO 8601 format in UTC timezone. |
| `end`      | `string (date-time)`                                                    | No       | The end date and time of the out of office period in ISO 8601 format in UTC timezone.   |
| `notes`    | `string`                                                                | No       | Optional notes for the out of office entry.                                             |
| `toUserId` | `number`                                                                | No       | The ID of the user covering for the out of office period, if applicable.                |
| `reason`   | `"unspecified" \| "vacation" \| "travel" \| "sick" \| "public_holiday"` | No       | the reason for the out of office entry, if applicable                                   |

## Output

Returns an object with these fields:

| Field      | Type                                                                    | Required | Description                                                                             |
| ---------- | ----------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------- |
| `userId`   | `number`                                                                | Yes      | The ID of the user.                                                                     |
| `toUserId` | `number`                                                                | No       | The ID of the user covering for the out of office period, if applicable.                |
| `id`       | `number`                                                                | Yes      | The ID of the ooo entry.                                                                |
| `uuid`     | `string`                                                                | Yes      | The UUID of the ooo entry.                                                              |
| `start`    | `string (date-time)`                                                    | Yes      | The start date and time of the out of office period in ISO 8601 format in UTC timezone. |
| `end`      | `string (date-time)`                                                    | Yes      | The end date and time of the out of office period in ISO 8601 format in UTC timezone.   |
| `notes`    | `string`                                                                | No       | Optional notes for the out of office entry.                                             |
| `reason`   | `"unspecified" \| "vacation" \| "travel" \| "sick" \| "public_holiday"` | No       | the reason for the out of office entry, if applicable                                   |

Cal.com enforces account role, plan, and availability requirements. Provider rejections surface as structured action failures with the HTTP status and any `Retry-After` delay.
