---
title: "Update User"
method: PATCH
path: "/v1/organizations/users/{user_email}"
tags: ["Organization Users"]
---

# Update User

`PATCH /v1/organizations/users/{user_email}`

Apply partial updates to an existing user.

## Path parameters

- `user_email` string, required

## Request body

- UserUpdateRequest — Partial update payload for a user.
  - `user_name` string, nullable — Updated display name.
  - `avatar_url` string, nullable — Updated profile image URL (e.g., custom avatar to override Gravatar).
  - `role` 'admin' | 'member' | 'viewer' — High-level organization role applied to users. Roles define the baseline permissions a user has within an organization: - ADMIN: Full administrative access including user management, billing, and organization settings. Can create/modify/delete all resources. - MEMBER: Standard user access. Can create and manage their own resources (namespaces, collections, clusters) but cannot manage other users or organization-level settings. - VIEWER: Read-only access. Can view resources and execute retrievers but cannot create, modify, or delete any resources.
  - `status` 'active' | 'suspended' | 'pending' — Lifecycle state of an organization user. Status values control whether a user can authenticate and access resources: - ACTIVE: User is fully operational and can authenticate with their API keys. - SUSPENDED: User access is temporarily disabled. API keys will not work but account data is preserved. Can be reactivated by an admin. - PENDING: User invitation has been created but not yet accepted. User cannot authenticate until they complete the onboarding flow.
  - `metadata` object, nullable — Replaces metadata with the provided dictionary when set.

## Response `200`

Successful Response

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/04b379bdbb7c/schema)