---
title: "Update users."
method: PUT
path: "/users/{id}"
tags: ["Users"]
---

# Update users.

`PUT /users/{id}`

## Path parameters

- `id` string, required

## Request body

- UsersUpdate
  - `user` object
    - `data_transfer_consent` boolean, nullable — Whether the user consents to the transfer of their personal information to the United States. The only way to revoke this consent is to delete the account.
    - `description` string, nullable
    - `faved_project_ids` number[] — Ordered list of IDs of projects the user has faved. Order of IDs in the array is the order in which they will be displayed
    - `email` string
    - `icon` object, nullable
    - `locale` string, nullable
    - `login` string
    - `make_observation_licenses_same` boolean — Whether a change to `preferred_observation_license` should be apply to all the user's existing observations
    - `make_photo_licenses_same` boolean — Whether a change to `preferred_photo_license` should be apply to all the user's existing photos
    - `make_sound_licenses_same` boolean — Whether a change to `preferred_sound_license` should be apply to all the user's existing sounds
    - `name` string, nullable
    - `pi_consent` boolean, nullable — Whether the user consents to the storage of their personal information. The only way to revoke this consent is to delete the account.
    - `place_id` integer, nullable — ID of place for localizing common names
    - `preferred_observation_fields_by` string
    - `preferred_observation_license` string, nullable
    - `preferred_photo_license` string, nullable
    - `preferred_project_addition_by` string
    - `preferred_sound_license` string, nullable
    - `prefers_automatic_taxonomic_changes` boolean
    - `prefers_comment_email_notification` boolean
    - `prefers_common_names` boolean
    - `prefers_community_taxa` boolean
    - `prefers_identification_email_notification` boolean
    - `prefers_infraspecies_identification_notifications` boolean
    - `prefers_mention_email_notification` boolean
    - `prefers_message_email_notification` boolean
    - `prefers_monthly_supporter_badge` boolean
    - `prefers_no_email` boolean
    - `prefers_no_tracking` boolean
    - `prefers_non_disagreeing_identification_notifications` boolean
    - `prefers_project_added_your_observation_email_notification` boolean
    - `prefers_project_curator_change_email_notification` boolean
    - `prefers_project_journal_post_email_notification` boolean
    - `prefers_receive_mentions` boolean
    - `prefers_redundant_identification_notifications` boolean
    - `prefers_scientific_name_first` boolean
    - `prefers_taxon_change_email_notification` boolean
    - `prefers_taxon_or_place_observation_email_notification` boolean
    - `prefers_user_observation_email_notification` boolean
    - `search_place_id` integer, nullable — ID of place for default observation searches
    - `site_id` integer, nullable
    - `time_zone` string, nullable
    - `password` string
    - `password_confirmation` string
  - `icon_delete` boolean

## Response `200`

A user.

- User, nullable
  - `id` integer, required — Unique auto-increment integer identifier.
  - `uuid` string, uuid
  - `created_at` string, date-time
  - `description` string, nullable
  - `faved_project_ids` number[] — Ordered list of IDs of projects the user has faved
  - `icon` string, nullable
  - `icon_url` string, nullable
  - `identifications_count` integer
  - `journal_posts_count` integer
  - `annotated_observations_count` integer
  - `last_active` string, date-time
  - `login` string
  - `monthly_supporter` boolean, nullable
  - `name` string, nullable
  - `observations_count` integer
  - `orcid` string, nullable
  - `preferences` object
    - `prefers_community_taxa` boolean — Whether the user allows the Community Taxon to be the taxon their observation is associated with
    - `prefers_observation_fields_by` 'anyone' | 'curators' | 'observer'
    - `prefers_project_addition_by` 'any' | 'joined' | 'none'
  - `roles` string[]
  - `site` Site, nullable
    - `id` integer, required — Unique auto-increment integer identifier.
    - `icon_url` string — URL of an icon image for the site
    - `locale` string, nullable — Default language code for users of this site
    - `name` string — Full name of the site
    - `place_id` integer, nullable — Integer ID of the default search place for this site
    - `site_name_short` string, nullable — Short name for this site
    - `url` string
  - `site_id` integer, nullable
  - `spam` boolean
  - `species_count` integer
  - `suspended` boolean
  - `updated_at` string, date-time

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/inaturalist/apis/inaturalist-version-2-api.md) · [All operations](https://skmtc.net/inaturalist/apis/inaturalist-version-2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inaturalist/inaturalist-version-2-api/revisions/f739db716aaf/schema)