---
title: "Update User"
method: POST
path: "/api/v1/users/{user_id}"
---

# Update User

`POST /api/v1/users/{user_id}`

## Request

- Base URL: `https://app.workramp.com`
- URL: `https://app.workramp.com/api/v1/users/{user_id}`
- Auth: API key in header `Authorization`

Updates a user's attributes

## Path parameters

- `user_id` integer, required

## Request body

- object
  - `email` string: [Optional]
  - `name` string: [Optional]
  - `isAdmin` boolean: [Optional]
  - `isDeleted` boolean: [Optional]
  - `managerEmails` string[]: [Optional] Array of existing manager emails.
  - `overwriteManagerEmails` boolean: [Optional] If set to true, user's managers will be exactly what `managerEmails` is set to. Having an empty array for `mangerEmails` while this is true will delete all managers of the user.
  - `custom_attributes` object: [Optional] An object that represents all custom attributes the user should have. This will OVERWRITE the existing custom attributes and be set exactly as the object that is passed in.
    - `key` string: API key for this custom attribute
    - `value` string: Value to set this custom attribute to
  - `update_custom_attributes` object: [Optional] Create/update custom attributes for this user without deleting the existing values first. Use this INSTEAD OF custom_attributes!
    - `key` string: API key for this custom attribute
    - `value` string: Value to set this custom attribute to

## Response `200`

200

- object
  - `id` integer
  - `name` string
  - `email` string
  - `isAdmin` boolean
  - `isDeleted` boolean
  - `isPermanentlyDeleted` boolean
  - `createdAt` number
  - `updatedAt` number
  - `mentors` object[]
    - `id` integer
    - `name` string
    - `email` string
    - `isAdmin` boolean
    - `isDeleted` boolean
    - `isPermanentlyDeleted` boolean
    - `createdAt` integer
    - `updatedAt` integer
  - `mentorsViaGroups` unknown[]
    - unknown

---

[API](https://skmtc.dev/workramp/apis/json-api.md) - [All operations](https://skmtc.dev/workramp/apis/json-api/llms.txt) - [OpenAPI document](https://skmtc.dev/workramp/apis/json-api/revisions/2cb77bf12793?raw)