---
title: "PATCH /v2/users/{user_id}"
method: PATCH
path: "/v2/users/{user_id}"
tags: ["users", "password"]
---

# PATCH /v2/users/{user_id}

`PATCH /v2/users/{user_id}`

Partially implemented. Currently only for changing password.

## Path parameters

- `user_id` string, required

## Request body

- object
  - `current_state` object, required
    - `attachments` Attachment[]
      - `content_type` string
      - `is_inline` boolean
      - `file_name` string
      - `size` integer
      - `temp_id` string
      - `url` string
      - `mime_boundary` string
    - `body` string
    - `body_is_plain` boolean
    - `date` string, date-time
    - `date_delete` string, date-time
    - `date_insert` string, date-time
    - `date_sort` string, date-time
    - `discussion_id` string
    - `external_references` ExternalReferences
      - `ancestors_id` string
      - `message_id` string
      - `parent_id` string
    - `excerpt` string
    - `user_identities` string[]
    - `importance_level` integer
    - `is_answered` boolean
    - `is_draft` boolean
    - `is_unread` boolean
    - `is_received` boolean
    - `message_id` string
    - `parent_id` string
    - `participants` Participant[]
      - `address` string, required
      - `contact_ids` string[]
      - `label` string
      - `protocol` string, required
      - `type` 'To' | 'Cc' | 'Bcc' | 'From' | 'Reply-To' | 'Sender', required
    - `privacy_features` PrivacyFeatures
    - `pi` PI
      - `technic` integer
      - `context` integer
      - `comportment` integer
      - `version` integer
    - `pi_message` PIMessage
      - `content` integer
      - `transport` integer
      - `social` integer
    - `raw_msg_id` string
    - `subject` string
    - `tags` string[]
    - `protocol` string
    - `user_id` string
  - `attachments` Attachment[]
    - `content_type` string
    - `is_inline` boolean
    - `file_name` string
    - `size` integer
    - `temp_id` string
    - `url` string
    - `mime_boundary` string
  - `body` string
  - `body_is_plain` boolean
  - `date` string, date-time
  - `date_delete` string, date-time
  - `date_insert` string, date-time
  - `date_sort` string, date-time
  - `discussion_id` string
  - `external_references` ExternalReferences
    - `ancestors_id` string
    - `message_id` string
    - `parent_id` string
  - `excerpt` string
  - `user_identities` string[]
  - `importance_level` integer
  - `is_answered` boolean
  - `is_draft` boolean
  - `is_unread` boolean
  - `is_received` boolean
  - `message_id` string
  - `parent_id` string
  - `participants` Participant[]
    - `address` string, required
    - `contact_ids` string[]
    - `label` string
    - `protocol` string, required
    - `type` 'To' | 'Cc' | 'Bcc' | 'From' | 'Reply-To' | 'Sender', required
  - `privacy_features` PrivacyFeatures
  - `pi` PI
    - `technic` integer
    - `context` integer
    - `comportment` integer
    - `version` integer
  - `pi_message` PIMessage
    - `content` integer
    - `transport` integer
    - `social` integer
  - `raw_msg_id` string
  - `subject` string
  - `tags` string[]
  - `protocol` string
  - `user_id` string

## Response `204`

Update successful. No body is returned.

## Other responses

- `400` — json payload malformed
- `401` — Unauthorized access
- `403` — Forbidden patch. Server is refusing to apply the given patch's properties to this ressource
- `404` — message not found
- `422` — json is valid but patch was semantically malformed or unprocessable

---

[API](https://skmtc.net/caliopen/apis/caliopen-http-rest-api.md) · [All operations](https://skmtc.net/caliopen/apis/caliopen-http-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/caliopen/caliopen-http-rest-api/revisions/f32b5d08284d/schema)