> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blobhub.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update User

Update a user's profile information. Providing a parameter will overwrite the existing value.

## **PATCH** `/users/:id`

### Path Parameters

| Parameter | Type   | Required | Description                                   |
| :-------- | :----- | :------- | :-------------------------------------------- |
| `id`      | string | Yes      | The unique ID or alias of the user to update. |

### Request Body

| Parameter     | Type   | Required | Description                                      |
| :------------ | :----- | :------- | :----------------------------------------------- |
| `alias`       | string | No       | New alias for the user. Must be globally unique. |
| `name`        | string | No       | User's full name.                                |
| `description` | string | No       | A short bio or description.                      |
| `url`         | string | No       | URL to a personal website or profile.            |

### Response

Returns an empty JSON object upon success.

### Example

<CodeGroup>
  ```json Request theme={null}
  {
    "name": "Jane Doe-Smith",
    "description": "AI Researcher"
  }
  ```

  ```json Response theme={null}
  {}
  ```
</CodeGroup>

### Identifier

The `id` parameter accepts a UUID, alias, or [`me`](/rest-api/conventions#the-me-alias).

### Permissions

Only the user themselves can update their profile. Requests targeting a different user
return `403 Forbidden`.

<Note>
  The `alias` field can only be set once. Attempting to change an existing alias returns an error.
</Note>