---
title: "Patch a user"
method: PATCH
path: "/account/v2/users/{userUuid}"
tags: ["User"]
---

# Patch a user

`PATCH /account/v2/users/{userUuid}`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/account/v2/users/{userUuid}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/account/v2/users/:userUuid/patch.ts> (a function with typed inputs; its response is checked against the schema)

Update ('patch') one or more fields in the user details. This only adds or updates the values for the properties that you include in the call; all other properties, and data already saved for them, are ignored

## Path parameters

- `userUuid` string, required

## Request body

- PatchUserAccountV2: Update user information
  - `boostUser` BoostUser, nullable
    - `apsUid` string
  - `externalId` string: External identifier of user
  - `firstName` string, nullable: First name of user
  - `lastName` string, nullable: Last name of user
  - `username` string, nullable: User name. If not provided, use the user's email address
  - `ldapId` string, nullable: LDAP identifier of user
  - `idpUuid` string, nullable: The external identity provider's ID for the user
  - `locale` string: User locale in the standard ISO 639-1 language code + ISO 3166-1 country code format. For example: 'en_US'
  - `currency` string: Currency
  - `roles` string[]: All users have ROLE_USER (end-user access). To assign the Network Manager, role use ROLE_CORPORATE_ADMIN. For company membership roles, see [UserCompanyMembershipAccountV2](#usercompanymembershipaccountv2).

## Response `200`

Success

- UserAccountV2, nullable: User information
  - `links` Link[]: Resource links
    - `href` string
    - `rel` string
  - `activated` boolean: Is this user activated
  - `boostUser` BoostUser, nullable
    - `apsUid` string
  - `creationDate` number: User creation date in UNIX Epoch milliseconds
  - `customAttributes` CustomAttributeAccountV2[]: Custom attributes for this company
    - `attributeType` 'TEXT' | 'MULTISELECT'
    - `hint` string: Localized hint
    - `label` string: Localized label
    - `name` string: Name
    - `value` string: Value
    - `valueKeys` string[]: Value keys
  - `email` string: Email address
  - `externalId` string: External identifier of user
  - `firstName` string, nullable: First name
  - `lastName` string, nullable: Last name
  - `allowLogin` boolean: The user is able to log into a marketplace. By default allowLogin=true
  - `lastSuccessfulLogin` number: User last successful login date in UNIX Epoch milliseconds
  - `ldapId` string, nullable: Ldap integration
  - `idpUuid` string, nullable: The external identity provider's ID for the user
  - `locale` string: User locale in the standard ISO 639-1 language code + ISO 3166-1 country code format. For example: 'en_US', 'fr_CA', and so on.
  - `metadata` object
  - `openid` string: OpenID URL
  - `picture` string, nullable: Profile picture URL
  - `roles` string[]: User roles. All responses include ROLE_USER (end-user access). If the user has the Network Manager role, this array also includes ROLE_CORPORATE_ADMIN. For company membership roles, see [UserCompanyMembershipAccountV2](#usercompanymembershipaccountv2).
  - `userId` number: ID
  - `username` string, nullable: User name. If not provided, use the user's email address
  - `uuid` string: Unique identifier of the user assigned by the AppDirect platform

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: User not found

## Changes

- **2026-11-06** `1fc240f06971`: 3 breaking, 10 info
  - the request's body type changed from no type to `object`
  - removed the media type `*/*` for the response with the status `200`
  - removed the media type `*/*` for the response with the status `404`
  - added the new optional request property `boostUser`
  - …9 more

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/account/v2/users/:userUuid/patch.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)