---
title: "Update a user by ID"
method: PATCH
path: "/users/{user_id}"
tags: ["users"]
---

# Update a user by ID

`PATCH /users/{user_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/users/{user_id}`
- Auth: HTTP bearer

Update a single user.

## Path parameters

- `user_id` string, required

## Request body

- UserUpdate
  - `email` string: Email of the User
  - `handle` string: Handle of the User
  - `isSuspended` boolean: Suspended status of the User
  - `name` string: Name of the User

## Response `200`

OK

- User
  - `handle` string
  - `id` string
  - `name` string
  - `apiKeyLastChangedAt` string, nullable
  - `email` string
  - `isSuspended` boolean
  - `passwordLastChangedAt` string, nullable

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

---

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