---
title: "Update End User Details"
method: PATCH
path: "/end-users/{id}"
tags: ["End Users"]
---

# Update End User Details

`PATCH /end-users/{id}`

Update the details of an existing end user identified by their SysAid ID. The new values provided will overwrite existing values.

## Request body

- EndUserUpdate
  - `firstName` string — The user's first name.
  - `lastName` string — The user's last name.
  - `displayName` string — The user's display name
  - `userEmail` string — The user's email address.
  - `isDisabled` boolean — Indicates if the user is disabled
  - `companyId` number, nullable — Unique ID of the company the user works for
  - `departmentId` number, nullable — Unique ID of the department the user belongs to
  - `locationId` number, nullable — Unique ID of the location associated with the user
  - `timezone` string — The time zone of the user
  - `language` string — The language used by the user (default is "en")
  - `workPhone` string — User's work phone number/extension
  - `mobile` string — User's mobile number
  - `receiveSRNotifications` boolean — Enable or disable automatic SR email notifications
  - `enablePortalLogin` boolean — Enable login to the End User Portal
  - `managerId` integer
  - `supervisorLevel` 'none' | 'department' | 'company' — Enable the user to have access to other's ssp tickets
  - `jobTitle` string, nullable — User's job title
  - `version` integer, required — The version number of the resource used for optimistic locking. This value must be provided when updating a resource to prevent conflicts caused by concurrent modifications. If the provided version does not match the current version on the server, the update will be rejected to ensure data consistency.

## Response `200`

End user updated successfully

- EndUserUpdateResponse
  - `success` boolean
  - `endUser` VersionedEndUserProperties
    - `firstName` string — The user's first name.
    - `lastName` string — The user's last name.
    - `displayName` string — The user's display name
    - `userEmail` string — The user's email address.
    - `isDisabled` boolean — Indicates if the user is disabled
    - `companyId` number, nullable — Unique ID of the company the user works for
    - `departmentId` number, nullable — Unique ID of the department the user belongs to
    - `locationId` number, nullable — Unique ID of the location associated with the user
    - `timezone` string — The time zone of the user
    - `language` string — The language used by the user (default is "en")
    - `workPhone` string — User's work phone number/extension
    - `mobile` string — User's mobile number
    - `receiveSRNotifications` boolean — Enable or disable automatic SR email notifications
    - `enablePortalLogin` boolean — Enable login to the End User Portal
    - `managerId` integer
    - `supervisorLevel` 'none' | 'department' | 'company' — Enable the user to have access to other's ssp tickets
    - `jobTitle` string, nullable — User's job title
    - `customColumnsFields` FlattenedCustomColumnsFields
    - `userName` string — The name of the user as provided by the SysAdmin
    - `company` Company
      - `name` string, nullable — Name of the company.
      - `address` string, nullable — Main company address.
      - `address2` string, nullable — Additional company address.
      - `city` string, nullable — The city in which the company is located.
      - `state` string, nullable — The state in which the company is located.
      - `zip` string, nullable — The company's zip code.
      - `country` string, nullable — The country in which the company is located.
      - `phone` string, nullable — The company’s phone number.
      - `fax` string, nullable — The company’s fax number.
      - `notes` string, nullable — Notes related to the company.
      - `emailAccount` string, nullable — Default email account.
      - `expirationDate` string, date, nullable — The date when the company's access to the help will expire.
      - `agreementId` integer, nullable — The ID of the SLA applied to the company.
      - `agreementStartDate` string, date, nullable — The start date of your service agreement with the company.
      - `agreementEndDate` string, date, nullable — The end date of your service agreement with the company.
      - `customFields` object — Company custom fields.
      - `version` integer, required — The latest retrievable version of the company and its details.
      - `id` integer, required — The unique identifier of the company in SysAid.
    - `groups` Group[]
      - `name` string, required — The group's name.
      - `type` 'general' | 'administrators' | 'end-users', required — The group type.
      - `supportLevel` integer — A number representing the support level (from existing support levels).
      - `companyId` integer, nullable — The unique identifier for the company associated with the group.
      - `email` string, email — The email address associated with the group.
      - `receiveAutomaticSrEmailNotifications` boolean — Indicates whether the group receives automatic SR email notifications.
      - `canBeAssignedToServiceRecord` boolean — Indicates if the group can be assigned to a service record. Not applicable if `type` is set to `END_USERS`.
      - `enableAutomaticDispatchOfServiceRecords` boolean — Determines if service records should be automatically dispatched. Only applicable if `canBeAssignedToServiceRecord` is `true`
      - `id` integer, required — The unique identifier of the group.
    - `version` integer — The version number of the resource used for optimistic locking. This value must be provided when updating a resource to prevent conflicts caused by concurrent modifications. If the provided version does not match the current version on the server, the update will be rejected to ensure data consistency.

## Other responses

- `400` — The request was invalid or cannot be served
- `401` — Authentication information is missing or invalid
- `404` — The specified resource was not found
- `409` — The request could not be completed due to a conflict with the current state of the resource. This typically occurs when attempting to create a duplicate resource, update a resource that has been modified by another process, or when business rules prevent the operation.

---

[API](https://skmtc.net/sysaid/apis/sysaid-public-api.md) · [All operations](https://skmtc.net/sysaid/apis/sysaid-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sysaid/sysaid-public-api/versions/38a43a1b2981/schema)