---
title: "Update an user entity"
method: POST
path: "/users/{userId}"
tags: ["users"]
---

# Update an user entity

`POST /users/{userId}`

## Path parameters

- `userId` integer, required

## Request body

- UpsertUserRequest
  - `avatar` string
  - `avatarId` string
  - `defaultWorkspaceId` integer, nullable
  - `description` string
  - `email` string, email, required
  - `firstName` string
  - `lastName` string
  - `notification` boolean
  - `organization` string
  - `userName` string, required
  - `waveBuildNotification` 'ALWAYS_ON' | 'ON_ERROR' | 'ALWAYS_OFF'

## Response `204`

OK - No content

## Other responses

- `400` — Bad request
- `403` — Operation not allowed

## Changes

> 14 revisions in range; 1 not diffed, 3 could not be searched.

- **2026-07-09** `aa8544683897` — 2 info
  - added the new optional request property `defaultWorkspaceId`
  - added the new optional request property `waveBuildNotification`
- **2026-01-20** `98d6b538c88e` — 7 warning
  - removed the request property `dateCreated`
  - removed the request property `deleted`
  - removed the request property `id`
  - removed the request property `lastAccess`
  - …3 more

[Change history](https://skmtc.dev/seqeralabs/apis/seqera-api/changes/users/:userId/post.md)

---

[API](https://skmtc.dev/seqeralabs/apis/seqera-api.md) · [All operations](https://skmtc.dev/seqeralabs/apis/seqera-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seqeralabs/seqera-api/revisions/97f7655d105a/schema)