Skip to content

users

User models, forms, and API key management.

Classes

UpdateProfileForm

Bases: BaseModel

Form for updating a user's profile information.

Note: This form is primarily used by the Auths router for profile updates, not by the Users router.

Used by:

Attributes

profile_image_url 
profile_image_url: str

The URL of the profile image.

name 
name: str

The full name of the user.

bio 
bio: Optional[str] = None

A brief biography or description of the user.

gender 
gender: Optional[str] = None

The user's gender.

date_of_birth 
date_of_birth: Optional[date] = None

The user's date of birth.

UserSettings

Bases: BaseModel

User settings configuration.

This model stores various user preferences, primarily related to the UI. It allows extra fields to accommodate future settings without strict schema changes.

Returned by: Used by:

Attributes

ui 
ui: Optional[dict] = {}

Dictionary containing UI-specific settings and preferences.

Dict Fields
  • pinnedModels (list[str], optional): List of model IDs pinned to the sidebar
  • toolServers (list[dict], optional): List of tool server configurations
  • detectArtifacts (bool, optional): Enable artifact detection in responses
  • showUpdateToast (bool, optional): Show update notification toasts
  • showChangelog (bool, optional): Show changelog notifications
  • showEmojiInCall (bool, optional): Show emoji during call interactions
  • voiceInterruption (bool, optional): Allow voice interruption during calls
  • collapseCodeBlocks (bool, optional): Collapse code blocks by default
  • expandDetails (bool, optional): Expand detail sections by default
  • notificationSound (bool, optional): Enable notification sounds
  • notificationSoundAlways (bool, optional): Always play notification sounds
  • stylizedPdfExport (bool, optional): Use stylized PDF export format
  • notifications (dict, optional): Notification configuration
  • imageCompression (bool, optional): Enable image compression
  • imageCompressionSize (any, optional): Image compression size settings
  • textScale (number, optional): Text scaling factor
  • widescreenMode (null, optional): Widescreen mode setting
  • largeTextAsFile (bool, optional): Treat large text as file attachments
  • promptAutocomplete (bool, optional): Enable prompt autocomplete
  • hapticFeedback (bool, optional): Enable haptic feedback
  • responseAutoCopy (any, optional): Auto-copy response settings
  • richTextInput (bool, optional): Enable rich text input
  • params (any, optional): Additional UI parameters
  • userLocation (any, optional): User location settings
  • webSearch (any, optional): Web search configuration
  • memory (bool, optional): Enable memory features
  • autoTags (bool, optional): Enable automatic tagging
  • autoFollowUps (bool, optional): Enable automatic follow-ups
  • backgroundImageUrl (null, optional): Background image URL
  • landingPageMode (str, optional): Landing page display mode
  • iframeSandboxAllowForms (bool, optional): Allow forms in iframe sandbox
  • iframeSandboxAllowSameOrigin (bool, optional): Allow same-origin in iframe sandbox
  • scrollOnBranchChange (bool, optional): Scroll on branch change
  • directConnections (null, optional): Direct connections setting
  • chatBubble (bool, optional): Show chat bubble interface
  • copyFormatted (bool, optional): Copy formatted text
  • models (list[str], optional): List of available model IDs
  • conversationMode (bool, optional): Enable conversation mode
  • speechAutoSend (bool, optional): Auto-send speech input
  • responseAutoPlayback (bool, optional): Auto-playback responses
  • audio (AudioSettings, optional): Audio settings configuration
  • showUsername (bool, optional): Show username in UI
  • notificationEnabled (bool, optional): Enable notifications
  • highContrastMode (bool, optional): Enable high contrast mode
  • title (TitleSettings, optional): Title settings configuration
  • showChatTitleInTab (bool, optional): Show chat title in browser tab
  • splitLargeDeltas (bool, optional): Split large delta updates
  • chatDirection (str, optional): Chat direction ('LTR', 'RTL', 'auto')
  • ctrlEnterToSend (bool, optional): Use Ctrl+Enter to send messages
  • system (str, optional): System configuration
  • seed (number, optional): Random seed value
  • temperature (str, optional): Temperature setting
  • repeat_penalty (str, optional): Repeat penalty value
  • top_k (str, optional): Top-k sampling value
  • top_p (str, optional): Top-p sampling value
  • num_ctx (str, optional): Context window size
  • num_batch (str, optional): Batch size
  • num_keep (str, optional): Number of tokens to keep
  • options (ModelOptions, optional): Model-specific options

The notifications field contains: - webhook_url (str, optional): Webhook URL for notifications

UserModel

Bases: BaseModel

Represents a user in the system.

This is the main user model containing profile information, status, settings, and system metadata.

Returned by: Subclassed by:

Attributes

id 
id: str

Unique identifier for the user.

name 
name: str

The user's full name.

email 
email: str

The user's email address.

username 
username: Optional[str] = None

The user's username (optional).

role 
role: str = 'pending'

The user's role. Common values: 'admin', 'user', 'pending'.

profile_image_url 
profile_image_url: Optional[str] = None

URL to the user's profile image.

profile_banner_image_url 
profile_banner_image_url: Optional[str] = None

URL to the user's profile banner image.

bio 
bio: Optional[str] = None

User's biography.

gender 
gender: Optional[str] = None

User's gender.

date_of_birth 
date_of_birth: Optional[date] = None

User's date of birth.

timezone 
timezone: Optional[str] = None

User's timezone.

presence_state 
presence_state: Optional[str] = None

Current presence state (e.g., 'online', 'idle').

status_emoji 
status_emoji: Optional[str] = None

Emoji representing the user's current status.

status_message 
status_message: Optional[str] = None

Text message representing the user's current status.

status_expires_at 
status_expires_at: Optional[int] = None

Timestamp when the status message expires.

info 
info: Optional[dict] = None

Additional user information dictionary.

Dict Fields
  • location (str, optional): User's location information, used for geolocation features and template variable replacement (e.g., {{USER_LOCATION}} in prompts)
  • Additional arbitrary key-value pairs may be stored as needed. This field is a flexible JSON storage that can contain any user-specific metadata.
settings 
settings: Optional[UserSettings] = None

User-specific settings.

api_key 
api_key: Optional[str] = None

User's API key (if generated).

oauth 
oauth: Optional[dict] = None

OAuth provider data.

Dict Fields
  • google (dict, optional): Google OAuth provider data
  • github (dict, optional): GitHub OAuth provider data
  • microsoft (dict, optional): Microsoft OAuth provider data
  • oidc (dict, optional): OpenID Connect OAuth provider data
  • feishu (dict, optional): Feishu OAuth provider data
Each provider dictionary contains
  • sub (str, required): Subject identifier from the OAuth provider
scim 
scim: Optional[dict] = None

SCIM provider data for external identity management.

Dict Fields
  • microsoft (dict, optional): Microsoft SCIM provider data
  • okta (dict, optional): Okta SCIM provider data
Each provider dictionary contains
  • external_id (str, required): External identifier from the SCIM provider
oauth_sub 
oauth_sub: Optional[str] = None

OAuth subject identifier.

last_active_at 
last_active_at: int

Timestamp of the last user activity (Unix epoch).

updated_at 
updated_at: int

Timestamp when the user was last updated (Unix epoch).

created_at 
created_at: int

Timestamp when the user was created (Unix epoch).

UserGroupIdsModel

Bases: UserModel

User model with associated group IDs.

Returned by:

Attributes

group_ids 
group_ids: list[str] = []

List of group IDs that the user belongs to.

UserGroupIdsListResponse

Bases: BaseModel

Response model for listing users with their group IDs.

Returned by:

Attributes

users 
users: list[UserGroupIdsModel]

List of users with group IDs.

total 
total: int

Total number of users matching the query.

UserModelResponse

Bases: UserModel

User model response that allows extra fields.

Returned by:

UserListResponse

Bases: BaseModel

Response model for listing users.

Returned by:

Attributes

users 
users: list[UserModelResponse]

List of users.

total 
total: int

Total number of users matching the query.

UserStatus

Bases: BaseModel

User status information.

Subclassed by: Used by:

Attributes

status_emoji 
status_emoji: Optional[str] = None

Emoji status.

status_message 
status_message: Optional[str] = None

Text status message.

status_expires_at 
status_expires_at: Optional[int] = None

Timestamp when the status expires (Unix epoch).

UserInfoResponse

Bases: UserStatus

Abbreviated user information including status.

Returned by:

Attributes

id 
id: str

User ID.

name 
name: str

User name.

email 
email: str

User email.

role 
role: str

User role.

bio 
bio: Optional[str] = None

User's biography.

groups 
groups: Optional[list] = []

List of groups the user belongs to.

is_active 
is_active: bool = False

Whether the user is currently active (based on recent activity).

UserInfoListResponse

Bases: BaseModel

Response model for listing abbreviated user info.

Returned by:

Attributes

users 
users: list[UserInfoResponse]

List of user info objects.

total 
total: int

Total count of users.

ActiveUsersResponse

Bases: BaseModel

Response model for listing active user IDs.

Attributes

user_ids 
user_ids: list[str]

List of active user IDs.

UserActiveResponse

Bases: UserStatus

User response including active status.

Returned by:

Attributes

name 
name: str

User name.

profile_image_url 
profile_image_url: Optional[str] = None

URL to profile image.

is_active 
is_active: bool

Whether the user is currently active (based on recent activity).

groups 
groups: Optional[list] = []

List of groups the user belongs to.

UserIdNameResponse

Bases: BaseModel

Minimal user response with ID and name.

Returned by:

Attributes

id 
id: str

User ID.

name 
name: str

User name.

UserIdNameStatusResponse

Bases: UserStatus

User response with ID, name, and active status.

Returned by:

Attributes

id 
id: str

User ID.

name 
name: str

User name.

is_active 
is_active: Optional[bool] = None

Whether the user is currently active.

UserIdNameListResponse

Bases: BaseModel

Response model for listing users with ID and name.

Returned by:

Attributes

users 
users: list[UserIdNameResponse]

List of user objects (ID and name).

total 
total: int

Total number of users.

UserNameResponse

Bases: BaseModel

User response with ID, name, and role.

Returned by: Subclassed by:

Attributes

id 
id: str

User ID.

name 
name: str

User name.

role 
role: str

User role.

UserProfileImageResponse

Bases: UserNameResponse

User response with profile image URL.

Returned by: Subclassed by:

Attributes

email 
email: str

User email.

profile_image_url 
profile_image_url: str

URL to the user's profile image.

WorkspacePermissions

Bases: BaseModel

Permissions related to workspace features.

Returned by:

Attributes

models 
models: bool = False

Access to models.

knowledge 
knowledge: bool = False

Access to knowledge base.

prompts 
prompts: bool = False

Access to prompts.

tools 
tools: bool = False

Access to tools.

skills 
skills: bool = False

Access to skills.

models_import 
models_import: bool = False

Permission to import models.

models_export 
models_export: bool = False

Permission to export models.

prompts_import 
prompts_import: bool = False

Permission to import prompts.

prompts_export 
prompts_export: bool = False

Permission to export prompts.

tools_import 
tools_import: bool = False

Permission to import tools.

tools_export 
tools_export: bool = False

Permission to export tools.

skills_import 
skills_import: bool = False

Permission to import skills.

skills_export 
skills_export: bool = False

Permission to export skills.

SharingPermissions

Bases: BaseModel

Permissions related to sharing features.

Returned by:

Attributes

models 
models: bool = False

Can share models.

public_models 
public_models: bool = False

Can share models publicly.

knowledge 
knowledge: bool = False

Can share knowledge.

public_knowledge 
public_knowledge: bool = False

Can share knowledge publicly.

prompts 
prompts: bool = False

Can share prompts.

public_prompts 
public_prompts: bool = False

Can share prompts publicly.

tools 
tools: bool = False

Can share tools.

public_tools 
public_tools: bool = True

Can share tools publicly (default True).

skills 
skills: bool = False

Can share skills.

public_skills 
public_skills: bool = False

Can share skills publicly.

notes 
notes: bool = False

Can share notes.

public_notes 
public_notes: bool = True

Can share notes publicly (default True).

public_chats 
public_chats: bool = False

Can share chats publicly.

public_calendars 
public_calendars: bool = False

Can share calendars publicly.

ChatPermissions

Bases: BaseModel

Permissions related to chat functionality.

The import_ field is serialized under the JSON key import (a Pydantic alias) because import is a reserved Python keyword. With populate_by_name=True, the field accepts both the alias import and the field name import_ on input.

Returned by:

Attributes

controls 
controls: bool = True

Access to chat controls.

valves 
valves: bool = True

Access to valves.

system_prompt 
system_prompt: bool = True

Ability to edit system prompt.

params 
params: bool = True

Ability to edit chat parameters.

file_upload 
file_upload: bool = True

Permission to upload files.

web_upload 
web_upload: bool = True

Permission to upload content from the web.

delete 
delete: bool = True

Permission to delete chats.

delete_message 
delete_message: bool = True

Permission to delete individual messages.

continue_response 
continue_response: bool = True

Permission to use 'continue' for responses.

regenerate_response 
regenerate_response: bool = True

Permission to regenerate responses.

rate_response 
rate_response: bool = True

Permission to rate responses.

edit 
edit: bool = True

Permission to edit messages.

share 
share: bool = True

Permission to share chats.

export 
export: bool = True

Permission to export chats.

import_ 
import_: bool = Field(default=True, alias='import')

Permission to import chats. JSON key is import (Python keyword).

stt 
stt: bool = True

Access to Speech-to-Text.

tts 
tts: bool = True

Access to Text-to-Speech.

call 
call: bool = True

Access to call feature.

multiple_models 
multiple_models: bool = True

Permission to use multiple models.

temporary 
temporary: bool = True

Permission to use temporary chats.

temporary_enforced 
temporary_enforced: bool = False

Whether temporary chat is enforced.

FeaturesPermissions

Bases: BaseModel

Permissions related to general features.

Returned by:

Attributes

api_keys 
api_keys: bool = False

Access to API keys.

direct_tool_servers 
direct_tool_servers: bool = False

Access to direct tool servers.

web_search: bool = True

Access to web search.

image_generation 
image_generation: bool = True

Access to image generation.

code_interpreter 
code_interpreter: bool = True

Access to code interpreter.

notes 
notes: bool = True

Access to notes.

channels 
channels: bool = True

Access to channels.

folders 
folders: bool = True

Access to folders.

memories 
memories: bool = True

Access to memories.

automations 
automations: bool = False

Access to automations.

calendar 
calendar: bool = True

Access to calendar.

webhooks 
webhooks: bool = False

Access to user webhooks.

SettingsPermissions

Bases: BaseModel

Permissions related to settings.

Returned by:

Attributes

interface 
interface: bool = True

Access to interface settings.

AccessGrantsPermissions

Bases: BaseModel

Permissions related to access grants.

Returned by:

Attributes

allow_users 
allow_users: bool = True

Whether to allow users to grant access to others.

UserPermissions

Bases: BaseModel

Comprehensive user permissions.

This model represents the structure of permissions returned by the system. It is used for default permissions configuration and user-specific permission checks.

Returned by: Used by:

Attributes

workspace 
workspace: WorkspacePermissions

Workspace-related permissions.

sharing 
sharing: SharingPermissions

Sharing-related permissions.

chat 
chat: ChatPermissions

Chat-related permissions.

features 
features: FeaturesPermissions

Feature-related permissions.

settings 
settings: SettingsPermissions

Settings-related permissions.

access_grants 
access_grants: AccessGrantsPermissions

Access grants related permissions.

UserResponse

Bases: UserNameResponse

User response with ID, name, role, and email.

Returned by:

Attributes

email 
email: str

User email.

UserUpdateForm

Bases: BaseModel

Form for updating a user.

Used by:

Attributes

role 
role: str

User role. Can be used to promote/demote users.

name 
name: str

User name.

email 
email: str

User email.

profile_image_url 
profile_image_url: str

Profile image URL.

password 
password: Optional[str] = None

New password (optional). If provided, the user's password will be updated.

ResourcePreviewItem

Bases: BaseModel

Minimal resource reference (id, name) used in preview responses.

Returned by:

Attributes

id 
id: str

Unique identifier of the resource.

name 
name: str

Display name of the resource.

ResourcePreviewList

Bases: BaseModel

Wrapper for a list of accessible resources plus a total count.

Returned by:

Attributes

items 
items: List[ResourcePreviewItem]

List of accessible resources the principal can read.

total 
total: int

Total number of resources of this type in the system (active for models).

UserPreviewUser

Bases: BaseModel

User reference embedded in the user preview response.

Returned by:

Attributes

id 
id: str

Unique identifier of the user.

name 
name: str

Display name of the user.

UserPreview

Bases: BaseModel

Response model for the user preview endpoint.

Shows what resources a specific user can access across all of their groups. Returned by GET /v1/users/{user_id}/preview (admin-only).

Returned by:

Attributes

user 
user: UserPreviewUser

The user being previewed.

groups 
groups: List[ResourcePreviewItem] = []

List of groups the user belongs to.

models 
models: ResourcePreviewList

Models accessible to the user (active models only) with total count.

knowledge 
knowledge: ResourcePreviewList

Knowledge bases accessible to the user with total count.

tools 
tools: ResourcePreviewList

Tools accessible to the user with total count.