---
title: "Update User"
method: PUT
path: "/users"
tags: ["/users"]
---

# Update User

`PUT /users`

Modify a given `User`.

Fields not included in the request body will not be modified.

## Request body

- TenantNewUserInfo — The schema used for creating new users or updating existing users.
  - `email` string, required — The email of the user
  - `is_tenant_admin` boolean — Flag indicating if the user is a tenant admin
  - `roles` UserRolesEnum[] — The user level roles of the user.
  - `agent_level_roles` AgentLevelUserRolesEnum[] — The user level roles of the user for agent level roles.
  - `per_agent_roles` PerAgentRoles[] — Per agent level roles for the user. If a user is granted any role under `agent_level_roles`, then the user has that role for all the agents. Only the roles that need to be updated should be part of this.
    - `agent_id` string, uuid, required — ID of the agent on which to grant/revoke the role.
    - `roles` AgentLevelUserRolesEnum[], required — The roles that are granted/revoked
    - `grant` boolean, required — When set to true, the roles will be granted o/w revoked.

## Response `200`

Successful Response

- EmptyResponse

## Other responses

- `422` — Validation Error

## Changes

- **2025-10-28** `c8152db45500` — 3 info
  - added the new `CONTEXTUAL_ADMIN` enum value to the request property `roles/items/`
  - added the new `CUSTOMER_ADMIN` enum value to the request property `roles/items/`
  - added the new `CUSTOMER_USER` enum value to the request property `roles/items/`
- **2025-08-26** `db7245c74772` — 3 info
  - added the new optional request property `agent_level_roles`
  - added the new optional request property `per_agent_roles`
  - added the new `SERVICE_ACCOUNT` enum value to the request property `roles/items/`
- **2025-05-08** `17bdb8a33fb4` — 1 warning, 7 info
  - removed the request property `per_agent_roles`
  - added the new `CONTEXTUAL_EXTERNAL_STAFF_USER` enum value to the request property `roles/items/`
  - added the new `CONTEXTUAL_INTERNAL_STAFF_USER` enum value to the request property `roles/items/`
  - added the new `CONTEXTUAL_STAFF_USER` enum value to the request property `roles/items/`
  - …4 more
- **2025-02-08** `d79ccb778953` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/contextualai/apis/endpoints/changes/users/put.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) · [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contextualai/endpoints/revisions/ca7f807eec8b/schema)