User Resource

A user represents a person or bot on Duvet.

User Object

Field	Type	Description
`id`	`string`	The user's UUID (v7, time-ordered)
`username`	`string`	The user's unique username
`alias`	`string?`	Display name override
`avatar`	`string?`	Avatar attachment ID
`banner`	`string?`	Banner attachment ID
`custom`	`string`	Custom status text
`flags`	`integer`	User flags bitfield (see Enums)
`badges`	`integer`	User badges bitfield (see Enums)
`is_bot`	`boolean`	Whether the user is a bot account
`email_verified`	`boolean`	Whether the user's email is verified
`created_at`	`ISO 8601`	When the user was created
`updated_at`	`ISO 8601`	When the user was last updated
`deleted_at`	`string?`	ISO 8601 soft-delete timestamp

Fields email and password are never included in API responses or gateway events.

Current User Object

What GET /api/users/@me and PATCH /api/users/@me return: the User object plus the private fields that are only ever shown to the user themselves.

Field	Type	Description
`birthdate`	`string?`	The user's birthdate
`phone`	`string?`	The user's phone number

Example

{
  "id": "019cf96a-3d5b-72c5-830f-75e85355d078",
  "username": "MARCROCK22",
  "alias": null,
  "avatar": "9bd6da82-c850-424b-89a0-9e4733263a45",
  "banner": "30a56bf1-b9ca-425b-bfd4-9f843e3ce45f",
  "custom": "",
  "flags": 1,
  "badges": 1,
  "is_bot": false,
  "email_verified": true,
  "created_at": "2025-10-30T00:22:21.000Z",
  "updated_at": "2026-04-06T12:00:00.000Z",
  "deleted_at": null
}