**Source URL:** https://limited.veevavault.dev/regulatory/vault-api/api-reference/19.1/users/update-users/update-single-user.md

# Update Single User

<Aside>Beginning in v18.1, Admins create and manage users with `user__sys` object records. Unless you are updating domain-only users, we strongly recommend using the [Update Object Records](/vault-api/api-reference/19.1/vault-objects/update-object-records) endpoint to update users.

</Aside>
Update information for a single user. To update information for multiuple users, see [Retrieve All Users](/vault-api/api-reference/19.1/users/retrieve-all-users).

<Endpoint path="/api/{version}/objects/users/{id}" method="PUT"></Endpoint>

## Headers {#headers}

<FieldTable>
| Name | Description |
| --- | --- |
| `Content-Type` | `application/x-www-form-urlencoded` |
| `Accept` | `application/json` (default) or `application/xml` |
</FieldTable>

## URI Path Parameters {#uri-path-parameters}

<FieldTable>
| Name | Description |
| --- | --- |
| `{id}` | The user `id` field value. Use the value `me` to update information for the currently authenticated user. |
</FieldTable>

## Example Request: Disable User at Domain-Level {#example-request-disable-user-at-domain-level}

Only Domain Admins may use this request.

When updating a user, domain_active__v can be (optionally) included in the input and set to either true or false to enable or disable the user at the domain-level. Disabling a user at the domain-level will disable the user in every Vault in your domain. Re-enabling a user enables them in the domain but does not re-activate them in their Vaults. After re-enabling a user, you must update their Vault membership to make them active in the individual Vaults.

This request will set the user (ID: 25001) profile to inactive in all Vaults in your domain. The user will still be a member in the Vaults and retain their license types and security profiles, but their user profile will be inactive and they will no longer have access to any Vaults in your domain.

## Example Request: Re-Enable User at Domain-Level {#example-request-re-enable-user-at-domain-level}

Only Domain Admins may use this request.

This request will set the (previously inactive) user (ID: 25001) profile to active in your Vault domain. However, they will still be inactive in and unable to access your domain Vaults. Use the Update Vault Membership request below to set their status to active in the individual Vaults in your domain.

## Example Request: Promote a User to Domain Admin {#example-request-promote-a-user-to-domain-admin}

Only Domain Admins may use this request.

This request will promote a user to Domain Admin. To remove a user from the Domain Admin role, set the `is_domain_admin__v` field to false. Each domain must have at least one user in the Domain Admin role.

## Request : Update User Profile Information {#request--update-user-profile-information}

<CodeExample title="">
```
curl -X PUT -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "user_timezone__v=America/Los Angeles" \
-d "company__v=VeevaPharm" \
-d "user_title__v=Product Manager" \
-d "alias__v=Skipper" \
https://myvault.veevavault.com/api/v15.0/objects/users/25001

```
</CodeExample>

## Request : Disable User at Domain-Level {#request--disable-user-at-domain-level}

<CodeExample title="">
```
curl -X PUT -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "domain_active__v=false" \
https://myvault.veevavault.com/api/v15.0/objects/users/25001

```
</CodeExample>

## Request : Re-Enable User at Domain-Level {#request--re-enable-user-at-domain-level}

<CodeExample title="">
```
curl -X PUT -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "domain_active__v=false" \
https://myvault.veevavault.com/api/v15.0/objects/users/25001

```
</CodeExample>

## Request : Promote a User to Domain Admin {#request--promote-a-user-to-domain-admin}

<CodeExample title="">
```
curl -X PUT -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "is_domain_admin__v=true" \
https://myvault.veevavault.com/api/v15.0/objects/users/25001

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "id": 25001
}

```
</CodeExample>

---

**Previous:** [Update Users](/regulatory/vault-api/api-reference/19.1/users/update-users)  
**Next:** [Update Multiple Users](/regulatory/vault-api/api-reference/19.1/users/update-users/update-multiple-users)