> ## 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 schedule

> Updates one Cal.com availability schedule.

`calcom.updateSchedule` updates one Cal.com availability schedule.

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

export default automation("Update schedule", () => {
  markSignificant(
    calcom.updateSchedule({
      scheduleId: 17,
      name: "Client hours",
      isDefault: true,
    }),
  )
})
```

## Input

Pass these fields:

| Field          | Type       | Required | Description             |
| -------------- | ---------- | -------- | ----------------------- |
| `scheduleId`   | `integer`  | Yes      | Must be greater than 0. |
| `name`         | `string`   | No       | —                       |
| `timeZone`     | `string`   | No       | —                       |
| `availability` | `object[]` | No       | —                       |
| `isDefault`    | `boolean`  | No       | —                       |
| `overrides`    | `object[]` | No       | —                       |

## Output

Returns an object with these fields:

| Field          | Type       | Required | Description |
| -------------- | ---------- | -------- | ----------- |
| `id`           | `number`   | Yes      | —           |
| `ownerId`      | `number`   | Yes      | —           |
| `name`         | `string`   | Yes      | —           |
| `timeZone`     | `string`   | Yes      | —           |
| `availability` | `object[]` | Yes      | —           |
| `isDefault`    | `boolean`  | Yes      | —           |
| `overrides`    | `object[]` | Yes      | —           |

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.