---
title: "Update an existing (authenticated) user's account password"
method: PUT
path: "/user/password"
---

# Update an existing (authenticated) user's account password

`PUT /user/password`

## Request

- Base URL: `https://api.border0.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.border0.com/user/password`
- Auth: API key in header `Authorization`

## Request body

- V1UpdateUserPasswordRequest
  - `mfa_passcode` string
  - `new_password` string
  - `password` string

## Response `200`

OK

- SerializerUser
  - `accepted_terms` boolean
  - `default_org` string
  - `email` string
  - `mfa_enabled` boolean
  - `name` string
  - `primary_organization` SerializerOrganization
    - `accepted_insights_terms_at` string
    - `account_id` integer
    - `dns_management_enabled` boolean
    - `id` string
    - `metadata` object
    - `mfa_required` boolean
    - `name` string
    - `needs_reauth` boolean
    - `owner_email` string
    - `private_network_enabled` boolean
    - `role` string
    - `setup_wizard` DatatypesJSONMap
    - `subdomain` string
    - `subscription` SerializerSubscription
      - `plan` SerializerPlan
        - `name` string
        - `slug` string
      - `subscription_limit` SerializerSubscriptionLimit
        - `admin_user_count` integer
        - `custom_domain_count` integer
        - `custom_idp_count` integer
        - `notification_count` integer
        - `organization_count` integer
        - `socket_count` integer
        - `socket_tcp_count` integer
        - `subscription_id` integer
        - `user_count` integer
  - `role` string
  - `sshkey` string
  - `subscription` SerializerSubscription
    - `plan` SerializerPlan
      - `name` string
      - `slug` string
    - `subscription_limit` SerializerSubscriptionLimit
      - `admin_user_count` integer
      - `custom_domain_count` integer
      - `custom_idp_count` integer
      - `notification_count` integer
      - `organization_count` integer
      - `socket_count` integer
      - `socket_tcp_count` integer
      - `subscription_id` integer
      - `user_count` integer
  - `survey_completed` boolean
  - `user_id` string
  - `user_name` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/border0/apis/border0-api.md) - [All operations](https://skmtc.dev/border0/apis/border0-api/llms.txt) - [OpenAPI document](https://skmtc.dev/border0/apis/border0-api/revisions/f0ccef7418d8?raw)