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

# Users

> Create and manage users, statuses, roles, and permissions.

All user endpoints require authentication plus the relevant `users.*` permission.

## Role values

Current role values are:

* `superAdmin`
* `admin`
* `user`

`superAdmin` cannot be created through `/api/v1/users`; it is bootstrap-only.

## Create user

```http theme={null}
POST /api/v1/users
```

Valid role values for normal user creation are `admin` and `user`.

## Update permissions

```json theme={null}
{
  "permissions": [
    "assets.read",
    "assets.create"
  ]
}
```

Permission names use dot notation such as `assets.read` and `users.managePermissions`.

## Constraints

* `admin` can only manage `user`
* `superAdmin` cannot be disabled
* `superAdmin` permissions cannot be edited