---
title: "Update user access level"
method: PUT
path: "/users/{id}"
tags: ["Users"]
---

# Update user access level

`PUT /users/{id}`

## Request

- Base URL: `https://api.cloudpepper.io`
- URL: `https://api.cloudpepper.io/users/{id}`
- Auth: HTTP bearer

Adjust a user's access level within your Account. This lets you promote users to administrators, restrict access for certain team members, or create custom permission sets for specific servers and instances. Any changes you make take effect immediately.

**Key Parameters:**
- `role`: New role to assign to this user (e.g., 'admin', 'full', 'readonly', 'custom').
- `permissions`: Object specifying per-resource access levels, required when `role` is `custom`. Keys are clouds_<server_ID> / instances_<instance_ID>, values are `read` (read-only permissions) or `write` (full permissions).

## Request body

- object
  - `role` 'admin' | 'full' | 'readonly' | 'custom', required: Role to assign to the user
  - `permissions` object: Custom permissions configuration (required when role is 'custom'). Keys are `clouds_<server_ID>` or `instances_<instance_ID>`, values are the access level for that resource.

## Response `200`

User updated successfully

- object
  - `uid` string: Unique identifier of the updated user

## Other responses

- `403`: Insufficient permissions (requires admin privileges)
- `404`: User not found

---

[API](https://skmtc.dev/cloudpepper/apis/cloudpepper-api-docs.md) · [All operations](https://skmtc.dev/cloudpepper/apis/cloudpepper-api-docs/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudpepper/apis/cloudpepper-api-docs/revisions/b6a59274cedc?raw)