---
title: "Update User"
method: PATCH
path: "/{site_id}/users/{user_id}"
tags: ["users"]
---

# Update User

`PATCH /{site_id}/users/{user_id}`

Update user details.

## Path parameters

- `site_id` string, required
- `user_id` string, required

## Response `200`

OK

- UserResultV2 — A result object containing a V2 User, from the legacy V2 API
  - `result` UserV2 — A User object derived from the legacy V2 User objects
    - `id` integer — Internal identifier for the user while accessing api.viafoura.co
    - `uuid` string, uuid — Internal identifier for the user while accessing all other APIs
    - `avatar_moderation_status` string — May be "pending_new", "pending_update", "rejected", "approved", or "none"
    - `badge_trusted` integer — If the user has been given the trusted badge. Boolean.
    - `ban_level` 'ghost' | 'hide' | 'posting' | 'login' | 'none' — Severity level of ban
    - `custom_badges` object — May contain custom badges
    - `date_created` integer — Unix timestamp of when the user was created (UTC timezone)
    - `email` string — The user's current email address, if the user has one
    - `email_notice_frequency` integer — The frequency of email notices, either never (0) or immediate (1)
    - `email_pending` string — The user's new email address, pending verification
    - `email_verification_status` string — The verification status of the user's current email address
    - `isNewUser` boolean — Usually false, except when a login call created a new user
    - `name` string — The user's name
    - `personalized_ads` integer — Whether the user has personalized ads enabled
    - `pic_large` string — A 120x120 avatar URL
    - `pic_small` string — A 60x60 avatar URL
    - `processing_status` string — Normally "completed", or "deleted" if GDPR deleted
    - `social_login_id` string — The user's identify provider's id for the user, if not empty
    - `social_login_provider` string — The user's identify provider, if not empty
    - `type` string — Always "user"
    - `user_privilege` 'none' | 'guest' | 'user' | 'moderator' | 'administrator' — Current user privilege
    - `username_pending` string — When user name moderation is enabled, the user's pending name
    - `username_moderation_status` string — One of "pending_new", "pending_update", "rejected", "approved", or "none"
    - `anonymous` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `bad_comments` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `badges` object — Deprecated object. Values of fields always 0.
    - `comments_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `comments_received` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `dislikes_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `dislikes_received` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `fingerprint` string — Deprecated. An unused random string of characters.
    - `last_ip` string — Deprecated. Unused.
    - `likes_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `likes_received` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `picture_comments_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `plain_comments_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `rank_comments_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `rank_comments_received` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `rank_likes_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `rank_likes_received` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `rank_overall` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `rank_subscriber_count` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `rating` number, float — Deprecated field kept for backwards compatibility. Always returns 0.
    - `shares` object — Deprecated object. Always empty.
    - `subscribed` boolean — Deprecated field kept for backwards compatibility.
    - `subscriber_count` integer — Deprecated field kept for backwards compatibility. Always returns 0.
    - `video_comments_made` integer — Deprecated field kept for backwards compatibility. Always returns 0.

---

[API](https://skmtc.net/viafoura/apis/engagement-api.md) · [All operations](https://skmtc.net/viafoura/apis/engagement-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/viafoura/engagement-api/versions/ea12eb6ecdc1/schema)
