---
title: "Update User"
method: PUT
path: "/core/v1/user"
tags: ["Users"]
---

# Update User

`PUT /core/v1/user`

## Request

- Base URL: `https://api.verkada.com`
- URL: `https://api.verkada.com/core/v1/user`
- Auth: one of:
  - API key in header `x-verkada-auth`
  - API key in header `x-api-key`

Updates a user's metadata for an organization based on either provided user ID or an external ID set during creation.

## Query parameters

- `user_id` string: The unique identifier of the user managed by Verkada.
- `external_id` string: A unique identifier managed externally provided by the consumer.

## Request body

- UpdateUserRequestBody
  - `company_name` string: The name of the company the user is part of.
  - `department` string: The name of the department the user is part of.
  - `department_id` string: The department ID of the department the user is in.
  - `email` string: The email of the user.
  - `employee_id` string: The user's employee ID, does not have to be unique.
  - `employee_title` string: The title of employee.
  - `employee_type` string: The type of employee.
  - `external_id` string: A unique identifier managed externally provided by the consumer.
  - `first_name` string: The first name of the user.
  - `last_name` string: The last name of the user.
  - `middle_name` string: The middle name of the user.
  - `phone` string: The main phone number of a user, E.164 format preferred.

## Response `200`

OK

- UpdateUserResponse
  - `active` boolean: Whether the user is active in the system.
  - `company_name` string: The name of the company the user is part of.
  - `department` string: The name of the department the user is part of.
  - `department_id` string: The department ID of the department the user is in.
  - `email` string: The email of the user.
  - `employee_id` string: The user's employee ID, does not have to be unique.
  - `employee_title` string: The title of employee.
  - `employee_type` string: The type of employee.
  - `external_id` string: A unique identifier managed externally provided by the consumer.
  - `first_name` string: The first name of the user.
  - `last_name` string: The last name of the user.
  - `middle_name` string: The middle name of the user.
  - `phone` string: The main phone number of a user, E.164 format preferred.
  - `user_id` string: The unique identifier of the user managed by Verkada.

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `409`: Conflict

---

[API](https://skmtc.dev/verkada/apis/core-api.md) - [All operations](https://skmtc.dev/verkada/apis/core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verkada/apis/core-api/revisions/f430cd1d7aff?raw)