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

> Updates one Cal.com team.

`calcom.updateTeam` updates one Cal.com team.

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

export default automation("Update team", () => {
  markSignificant(
    calcom.updateTeam({ teamId: 17, name: "Platform Engineering" }),
  )
})
```

## Input

Pass these fields:

| Field                          | Type      | Required | Description                                                                                                                                                                            |
| ------------------------------ | --------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `teamId`                       | `integer` | Yes      | Must be greater than 0.                                                                                                                                                                |
| `name`                         | `string`  | No       | Name of the team. Maximum 155 characters. Cannot contain links or URLs.                                                                                                                |
| `slug`                         | `string`  | No       | Team slug                                                                                                                                                                              |
| `logoUrl`                      | `string`  | No       | URL of the teams logo image                                                                                                                                                            |
| `calVideoLogo`                 | `string`  | No       | —                                                                                                                                                                                      |
| `appLogo`                      | `string`  | No       | —                                                                                                                                                                                      |
| `appIconLogo`                  | `string`  | No       | —                                                                                                                                                                                      |
| `bio`                          | `string`  | No       | —                                                                                                                                                                                      |
| `hideBranding`                 | `boolean` | No       | —                                                                                                                                                                                      |
| `isPrivate`                    | `boolean` | No       | —                                                                                                                                                                                      |
| `hideBookATeamMember`          | `boolean` | No       | —                                                                                                                                                                                      |
| `metadata`                     | `object`  | No       | You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters. Values can be strings (up to 500 characters), numbers, or booleans. |
| `theme`                        | `string`  | No       | —                                                                                                                                                                                      |
| `brandColor`                   | `string`  | No       | —                                                                                                                                                                                      |
| `darkBrandColor`               | `string`  | No       | —                                                                                                                                                                                      |
| `bannerUrl`                    | `string`  | No       | URL of the teams banner image which is shown on booker                                                                                                                                 |
| `timeFormat`                   | `number`  | No       | —                                                                                                                                                                                      |
| `timeZone`                     | `string`  | No       | Time zone used for the team's default Monday-to-Friday schedule from 9 AM to 5 PM. Defaults to `"Europe/London"`.                                                                      |
| `weekStart`                    | `string`  | No       | —                                                                                                                                                                                      |
| `bookingLimits`                | `string`  | No       | —                                                                                                                                                                                      |
| `includeManagedEventsInLimits` | `boolean` | No       | —                                                                                                                                                                                      |

## Output

Returns an object with these fields:

| Field                 | Type             | Required | Description                                                                                          |
| --------------------- | ---------------- | -------- | ---------------------------------------------------------------------------------------------------- |
| `id`                  | `number`         | Yes      | —                                                                                                    |
| `parentId`            | `number`         | No       | —                                                                                                    |
| `name`                | `string`         | Yes      | —                                                                                                    |
| `slug`                | `string`         | No       | —                                                                                                    |
| `logoUrl`             | `string \| null` | No       | Team logo. Cal.com may return an absolute URL or a provider-relative path such as `/api/avatar/...`. |
| `calVideoLogo`        | `string (uri)`   | No       | —                                                                                                    |
| `appLogo`             | `string (uri)`   | No       | —                                                                                                    |
| `appIconLogo`         | `string (uri)`   | No       | —                                                                                                    |
| `bio`                 | `string`         | No       | —                                                                                                    |
| `hideBranding`        | `boolean`        | No       | —                                                                                                    |
| `isOrganization`      | `boolean`        | Yes      | —                                                                                                    |
| `isPrivate`           | `boolean`        | No       | —                                                                                                    |
| `hideBookATeamMember` | `boolean`        | No       | Default: `false`.                                                                                    |
| `metadata`            | `object`         | No       | —                                                                                                    |
| `theme`               | `string`         | No       | —                                                                                                    |
| `brandColor`          | `string`         | No       | —                                                                                                    |
| `darkBrandColor`      | `string`         | No       | —                                                                                                    |
| `bannerUrl`           | `string (uri)`   | No       | —                                                                                                    |
| `timeFormat`          | `number`         | No       | —                                                                                                    |
| `timeZone`            | `string`         | No       | Default: `"Europe/London"`.                                                                          |
| `weekStart`           | `string`         | No       | Default: `"Sunday"`.                                                                                 |

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.