# Update a user

Updates an existing user by their . You can change their name, email address, or assigned role.


Endpoint: PUT /users/{user_id}
Version: 1.0.0
Security: basicAuth

## Path parameters:

  - `user_id` (integer, required)
    The unique ID of the user to update
    Example: 837154

## Request fields (application/json):

  - `user_name` (string, required)
    Example: "Abby Smith"

  - `user_email` (string, required)
    Example: "abby+jackson@signable.co.uk"

  - `role_id` (string, required)
    Role assigned to the user:
- "1" = User
- "2" = Admin
- "3" = Super-Admin
    Enum: "1", "2", "3"

## Response 200 fields (application/json):

  - `http` (integer)
    Example: 200

  - `message` (string)
    Example: "Abby Smith has been updated in your user list."

  - `href` (string)
    Example: "https://api.signable.co.uk/v1/users/837154"

  - `user_id` (integer)
    Example: 837154

  - `role_id` (string)
    Enum: "1", "2", "3"

  - `user_name` (string)
    Example: "Abby Smith"

  - `user_email` (string)
    Example: "abby+jackson@signable.co.uk"

  - `user_updated` (string)
    Example: "2025-07-07T08:38:54+0000"