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

# Update a user

`PUT /users/{id}`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/users/{id}`
- Auth: HTTP bearer

Update an internal user's profile (role, department, persona)

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateUserInput
  - `job_title` string
  - `department` string
  - `persona` 'internal_admin' | 'internal_user'

## Response `200`

User updated successfully

- object
  - `success` boolean
  - `data` InternalUser
    - `id` string, uuid
    - `email` string, email
    - `first_name` string
    - `last_name` string
    - `job_title` string
    - `department` string
    - `phone` string
    - `avatar_url` string
    - `is_active` boolean
    - `last_login_at` string, date-time
    - `created_at` string, date-time
    - `persona` 'internal_admin' | 'internal_user'
    - `persona_display` 'Admin' | 'Cohort Manager'
  - `message` string

## Other responses

- `400`: Bad request - validation error
- `401`: Unauthorized
- `404`: User not found

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)