> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exulu.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Users
> GraphQL types for users, roles, and authentication
## user
User accounts for authentication and access control.
```graphql theme={null}
type user {
id: Int!
name: String
email: String!
emailVerified: Date
image: String
password: String
type: String # "api" | "user"
apikey: String
role: ID
super_admin: Boolean
createdAt: Date!
updatedAt: Date!
}
```
**Example query:**
```graphql theme={null}
query {
usersPagination(
filters: [{ type: { eq: "user" } }]
) {
items {
id
name
email
role
super_admin
}
}
}
```
The `password` and `apikey` fields are write-only for security. They are hashed with bcrypt and cannot be retrieved.
## role
Role definitions for RBAC.
```graphql theme={null}
type role {
id: ID!
name: String!
agents: String # "read" | "write"
evals: String
workflows: String
variables: String
users: String
api: String
createdAt: Date!
updatedAt: Date!
}
```
**Example mutation:**
```graphql theme={null}
mutation {
rolesCreateOne(
input: {
name: "Developer"
agents: "write"
evals: "write"
workflows: "read"
variables: "read"
users: "read"
}
) {
item {
id
name
}
}
}
```
## Permission Levels
Roles support two permission levels for each resource type:
* **read** - View resources
* **write** - View and modify resources
## Related Types
Resource-level access control
User conversation sessions
User activity statistics
View all core types