---
title: "Update a user with the given id"
method: PUT
path: "/users/{user_id}"
tags: ["Users"]
---

# Update a user with the given id

`PUT /users/{user_id}`

Updates a user's name and permissions.

## Path parameters

- `user_id` integer, required

## Request body

- UpdateUserRequest
  - `first_name` string — First name of the user.
  - `last_name` string — Last name of the user.
  - `is_administrator` boolean — If this user is an administrator. Administrators always have access to all dashboards, as well as the ability to change all settings for an account.
  - `external_user_id` string — The external id of the user. The external id is only used as part of the api to label users for filtering and searching. Multiple users can have the same external id.
  - `permissions` UserPermission[]
    - `dashboard_id` integer — The dashboard identifier. This will be used with all API calls at dashboard level.
    - `role` string — Specific permission level of this user. Can be either "Manager" or "CSR" (Customer Service Rep). For giving a user admin permissions, see the is_administrator user flag.

## Response `200`

The user was updated.

- User
  - `id` integer — The user identifier. Required to update or delete users.
  - `first_name` string — First name of the user.
  - `last_name` string — Last name of the user.
  - `is_administrator` boolean — If this user is an administrator. Administrators always have access to all dashboards, as well as the ability to change all settings for an account.
  - `email` string — Email address of the user. The email address functions as the user's username.
  - `external_user_id` string — The external id of the user. The external id is only used as part of the api to label users for filtering and searching. Multiple users can have the same external id.
  - `permissions` UserPermission[]
    - `dashboard_id` integer — The dashboard identifier. This will be used with all API calls at dashboard level.
    - `role` string — Specific permission level of this user. Can be either "Manager" or "CSR" (Customer Service Rep). For giving a user admin permissions, see the is_administrator user flag.

## Other responses

- `400` — Bad request. Sent if required properties are omitted or invalid.
- `401` — Unauthorized. Sent if the API key is omitted or invalid.

---

[API](https://skmtc.net/textrequest/apis/text-request-api-v3.md) · [All operations](https://skmtc.net/textrequest/apis/text-request-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textrequest/text-request-api-v3/revisions/e4e42efcd650/schema)