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

# Users & Roles

> User management and role assignments

**Users** are identified by email. They can be created via the management API, declarative config, or the console. Authentication is via OTP (email one-time password).

**Roles** group permissions together. Users can belong to multiple roles. All permissions across all of a user's roles are combined.

**User endpoints:**

```
GET    /api/v1/users                    # List users (admin)
POST   /api/v1/users                    # Create user (admin)
GET    /api/v1/users/{id}              # Get user
PATCH  /api/v1/users/{id}              # Update user
DELETE /api/v1/users/{id}              # Delete user (admin)
```

**Role endpoints:** See [Managing Roles](#managing-roles).