Sign in
users

Update an existing user's information.

Update existing user.

put/v1/users/{id}

Path parameters

idstring required
Example:123

The user ID.

Headers

X-Trace-Idstring uuid
Example:40c71bbb-c676-4f24-83cf-cc725d7d7a00

Unique identifier associated with this request.

Request body

created_atstring date-time
updated_atstring date-time
emailstring email required

The new users email address.

blockedboolean

Boolean to indicate if the user is blocked.

blocked_code'email_changed' | 'null' string nullable

If you say the user must be blocked, this will be the reason code.

role'owner' | 'demo' | 'null' string nullable

Role for the user. Can be empty or omitted.

Example request

{
  "created_at": "2026-08-01T00:00:00+00:00",
  "updated_at": "2026-08-01T00:00:00+00:00",
  "email": "james@firefly-iii.org",
  "blocked_code": "email_changed",
  "role": "owner"
}

Response

Updated user stored, result in response

Changes