---
title: "Update a user"
method: PATCH
path: "/v2/organizations/{orgId}/users/{userId}"
tags: ["Orgs / Users"]
---

# Update a user

`PATCH /v2/organizations/{orgId}/users/{userId}`

## Path parameters

- `orgId` number, required
- `userId` number, required

## Headers

- `Authorization` string
- `x-cal-secret-key` string
- `x-cal-client-id` string

## Request body

- UpdateOrganizationUserInput

## Response `200`

- GetOrganizationUserOutput
  - `status` 'success' | 'error', required
  - `data` GetOrgUsersWithProfileOutput, required
    - `id` number, required — The ID of the user
    - `username` string, nullable — The username of the user
    - `name` string, nullable — The name of the user
    - `email` string, required — The email of the user
    - `emailVerified` string, date-time, nullable — The date when the email was verified
    - `bio` string, nullable — The bio of the user
    - `avatarUrl` string, nullable — The URL of the user's avatar
    - `timeZone` string, required — The time zone of the user
    - `weekStart` string, required — The week start day of the user
    - `appTheme` string, nullable — The app theme of the user
    - `theme` string, nullable — The theme of the user
    - `defaultScheduleId` number, nullable — The ID of the default schedule for the user
    - `locale` string, nullable — The locale of the user
    - `timeFormat` number, nullable — The time format of the user
    - `hideBranding` boolean, required — Whether to hide branding for the user
    - `brandColor` string, nullable — The brand color of the user
    - `darkBrandColor` string, nullable — The dark brand color of the user
    - `allowDynamicBooking` boolean, nullable — Whether dynamic booking is allowed for the user
    - `createdDate` string, date-time, required — The date when the user was created
    - `verified` boolean, nullable — Whether the user is verified
    - `invitedTo` number, nullable — The ID of the user who invited this user
    - `metadata` object
    - `profile` ProfileOutput, required
      - `id` number, required — The ID of the profile of user
      - `organizationId` number, required — The ID of the organization of user
      - `userId` number, required — The IDof the user
      - `username` string, nullable — The username of the user within the organization context

## Changes

- **2025-09-26** (v2) `daa3e48bc03a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/calcom/apis/cal-diy-api-v2/changes/v2/organizations/:orgId/users/:userId/patch.md)

---

[API](https://skmtc.dev/calcom/apis/cal-diy-api-v2.md) · [All operations](https://skmtc.dev/calcom/apis/cal-diy-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/calcom/apis/cal-diy-api-v2/revisions/da86f193ae4a?raw)