---
title: "Update User"
method: PATCH
path: "/api/v3/user/{user_id}"
tags: ["User"]
---

# Update User

`PATCH /api/v3/user/{user_id}`

## Request

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

Update User.

## Path parameters

- `user_id` string, required

## Request body

- UpdateUserInput
  - `email` string
  - `name` string
  - `status` 'ACTIVE' | 'SUSPENDED'
  - `username` string

## Response `200`

OK

- User: Represents a human user in Benchling who can log in, perform actions, and own data. Users belong to one or more Organizations and may be members of Teams within those organizations. As an Owner, users can own Projects, Folders, and other resources. As a Principal, users can be assigned as reviewers, authors, or collaborators on various items. Users have attributes like email and username for identification. Users are distinct from `ServicePrincipal`, which represents non-human service accounts used for integrations.
  - `__typename` string
  - `createdAt` string, datetime
  - `email` string
  - `id` string
  - `lastSeen` string, datetime, nullable
  - `modifiedAt` string, datetime
  - `name` string, nullable
  - `status` 'ACTIVE' | 'SUSPENDED'
  - `username` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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