---
title: "Partially update user profile"
method: PATCH
path: "/users/{id}"
tags: ["Users"]
---

# Partially update user profile

`PATCH /users/{id}`

Update specific fields of a user's profile.

**Special Handling**: If only 'states' is provided in the request,
this will redirect to the states update endpoint for proper processing.

**Authentication Required**: Yes
**Permissions**: Users can update their own profile, admins can update any user

**Updatable Fields**:
- Personal information (name, email, phone)
- Profile settings and preferences
- Organization affiliation (admin only)
- User roles (with proper permissions)

## Request body

- UserBasic
  - `id` integer
  - `first_name` string, required — User first name.
  - `last_name` string, required — User last name.
  - `referring_user` integer, nullable — User who referred this user.
  - `organization` integer, nullable — Organization to which the user belongs.
  - `files` FileJoin[]
    - `tag` string, nullable — User-generated tag(s) or desription.
    - `title` string, nullable — A user-generated title, such as exterior_front, exterior_rear, interior, basement, friends, headquarters, user manual, tornado path, furthest extent, etc. Note: file_files.title and location_locations.name are the default titles. However, this field allows the user to create their own title if it is shared. It may or may not be implemented.
    - `notes` string, nullable — Any user-specific notes, caption, or description for the file. Note: file_files.notes is the default captions. However, this field allows the user to create their own caption if they wish, e.g. if someone else shares it with them. It may or may not be implemented.
    - `created_at` string, date-time — Timestamp when the file was attached to the object.
    - `file_updated_at` string
    - `id` integer
    - `file` integer, nullable, required — The file.id of the file being attached to object_id.
    - `filename` string
    - `url` string
    - `full_url` string
    - `general_file_url` string
    - `blog_url` string
    - `large_blog_url` string
    - `large_thumbnail_url` string
    - `small_thumbnail_url` string
    - `filename_original` string
    - `file_type_t` string
    - `mime_content_type` string
    - `attr` string
    - `image_exif` string

## Response `200`

OK

- UserBasic
  - `id` integer
  - `first_name` string, required — User first name.
  - `last_name` string, required — User last name.
  - `referring_user` integer, nullable — User who referred this user.
  - `organization` integer, nullable — Organization to which the user belongs.
  - `files` FileJoin[]
    - `tag` string, nullable — User-generated tag(s) or desription.
    - `title` string, nullable — A user-generated title, such as exterior_front, exterior_rear, interior, basement, friends, headquarters, user manual, tornado path, furthest extent, etc. Note: file_files.title and location_locations.name are the default titles. However, this field allows the user to create their own title if it is shared. It may or may not be implemented.
    - `notes` string, nullable — Any user-specific notes, caption, or description for the file. Note: file_files.notes is the default captions. However, this field allows the user to create their own caption if they wish, e.g. if someone else shares it with them. It may or may not be implemented.
    - `created_at` string, date-time — Timestamp when the file was attached to the object.
    - `file_updated_at` string
    - `id` integer
    - `file` integer, nullable, required — The file.id of the file being attached to object_id.
    - `filename` string
    - `url` string
    - `full_url` string
    - `general_file_url` string
    - `blog_url` string
    - `large_blog_url` string
    - `large_thumbnail_url` string
    - `small_thumbnail_url` string
    - `filename_original` string
    - `file_type_t` string
    - `mime_content_type` string
    - `attr` string
    - `image_exif` string

---

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