---
title: "Fully update a user (admin only)"
method: PUT
path: "/api/admin/users/{id}"
tags: ["Administration/Users"]
---

# Fully update a user (admin only)

`PUT /api/admin/users/{id}`

## Path parameters

- `id` string, required

## Request body

- object
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `email` string, nullable
  - `langId` string, nullable
  - `isBlocked` boolean
  - `developmentTag` 'EXPERIMENTAL' | 'ALPHA' | 'BETA', nullable

## Response `200`

Default Response

- object
  - `id` string, required
  - `firstName` string, nullable, required
  - `lastName` string, nullable, required
  - `email` string, nullable, required
  - `primaryCompanyId` string, nullable, required
  - `primaryRole` string, nullable, required
  - `role` string, nullable, required
  - `langId` string, nullable, required
  - `isBlocked` boolean, required
  - `developmentTag` string, nullable, required
  - `avatarFileUrl` string, nullable, required
  - `originalAvatarFileUrl` string, nullable, required
  - `enabledDevelopmentTags` object[], required
    - `featureId` string, required
    - `tag` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `isEnabled` number, required
  - `updatedAt` union, required
    - string
    - string, date-time

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-08-31** `97e51f27dc77` — 18 breaking, 21 info
  - request property `developmentTag` was restricted to a list of enum values
  - request property `developmentTag` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `email` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `firstName` list-of-types was narrowed by removing types `null` from media type `application/json`
  - …35 more
- **2026-08-12** `ac2cf3c5eae2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/admin/users/:id/put.md)

---

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