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

# Users

> Create and manage users in your organization

# Users

A **User** represents a person or bot account in your organization. Users can be assigned to teams, given roles, and associated with domains for governance purposes.

<Info>
  Entity schema follows the [OpenMetadata Standard](https://openmetadatastandards.org/teams-users/user/).
</Info>

## Fully Qualified Name

The FQN format for a user is simply the username:

```
username
```

For example: `aaron_johnson0`

***

## API Endpoints

| Method   | Endpoint                            | Description                                                                         |
| -------- | ----------------------------------- | ----------------------------------------------------------------------------------- |
| `PUT`    | `/v1/users`                         | [Create or update a user](/v1.12.x/api-reference/teams-and-users/users/create)      |
| `POST`   | `/v1/users`                         | [Create a user (POST variant)](/v1.12.x/api-reference/teams-and-users/users/create) |
| `GET`    | `/v1/users`                         | [List users](/v1.12.x/api-reference/teams-and-users/users/list)                     |
| `GET`    | `/v1/users/{id}`                    | [Get by ID](/v1.12.x/api-reference/teams-and-users/users/retrieve)                  |
| `GET`    | `/v1/users/name/{fqn}`              | [Get by FQN](/v1.12.x/api-reference/teams-and-users/users/retrieve)                 |
| `PATCH`  | `/v1/users/{id}`                    | [Update by ID](/v1.12.x/api-reference/teams-and-users/users/update)                 |
| `PATCH`  | `/v1/users/name/{fqn}`              | [Update by name](/v1.12.x/api-reference/teams-and-users/users/update)               |
| `DELETE` | `/v1/users/{id}`                    | [Delete by ID](/v1.12.x/api-reference/teams-and-users/users/delete)                 |
| `DELETE` | `/v1/users/name/{fqn}`              | [Delete by name](/v1.12.x/api-reference/teams-and-users/users/delete)               |
| `PUT`    | `/v1/users/restore`                 | [Restore soft-deleted user](/v1.12.x/api-reference/teams-and-users/users/delete)    |
| `GET`    | `/v1/users/{id}/versions`           | [List versions](/v1.12.x/api-reference/teams-and-users/users/versions)              |
| `GET`    | `/v1/users/{id}/versions/{version}` | [Get specific version](/v1.12.x/api-reference/teams-and-users/users/versions)       |