---
title: "Update a BadgeUser"
method: PATCH
path: "/v2/users/{idOrEntityId}"
tags: ["Users"]
---

# Update a BadgeUser

`PATCH /v2/users/{idOrEntityId}`

## Path parameters

- `idOrEntityId` string, required

## Request body

- V2UserForUpdate
  - `firstName` string
  - `lastName` string
  - `marketingOptIn` boolean

## Response `200`

OK

- LegacyResponseWrapperV2User
  - `errorCode` string, nullable
  - `fieldErrors` object, required
  - `latestTermsVersion` integer, nullable
  - `nonFieldErrors` string[], required
  - `result` V2User[], required
    - `agreedTermsVersion` integer, nullable — The version of the terms of use that the user has agreed to
    - `badgrDomain` string, nullable — The front-end domain of badgr (whitelabel) the user should use
    - `emails` V2UserEmail[], required — Emails of the user
      - `caseVariants` string[], required
      - `email` string, email, required — Email address
      - `primary` boolean, required
      - `verified` boolean, required
    - `entityId` string, required — Unique identifier for this BadgeUser
    - `entityType` string, required
    - `firstName` string, required — Given name
    - `hasAgreedToLatestTermsVersion` boolean, required
    - `hasPasswordSet` boolean, nullable
    - `id` string, required
    - `isImplementationUser` boolean, required — Whether this user is an implementation user
    - `isSuperUser` boolean, required — Whether this user has superuser privileges
    - `lastName` string, required — Family name
    - `marketingOptIn` boolean, nullable — Indicates if the user has opted in to marketing communications
    - `recipient` V2UserRecipient — Primary recipient identifier of the user.
      - `identity` string, required
      - `type` 'email' | 'url' | 'telephone', required
    - `telephone` string[], required — List of verified telephone identifiers associated with the user profile
    - `url` string[], required — List of verified URL identifiers associated with the user profile
  - `status` BadgrStatus, required
    - `description` string, required
    - `success` boolean, required
  - `timestamp` string, date-time, nullable
  - `validationErrors` string[], required
  - `warnings` object, required

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/instructure/apis/public-api-docs.md) · [All operations](https://skmtc.net/instructure/apis/public-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instructure/public-api-docs/revisions/44eb39b4bd65/schema)