Menu
CLI

reflexio user-profiles

Manage user profiles extracted from interactions.

Manage user profiles. Profiles are normally derived automatically from published interactions (reflexio publish → reflexio user-profiles regenerate), but you can also seed them manually with add.


Command: reflexio user-profiles list

List profiles. With --user-id, queries a single user; without it, lists profiles across every user in the org.

Terminal
reflexio user-profiles list [OPTIONS]
PropTypeDefaultDescription
--user-id?strnoneLimit results to a single user. Omit to list across all users.
--limit?int20Maximum number of profiles to return.
--status?strnoneStatus filter. One of "current", "pending", or "archived".
Terminal
reflexio user-profiles list --user-id user_123 --status current

Semantic search over profiles for a specific user. A --user-id is required — cross-user profile search is not currently supported.

Terminal
reflexio user-profiles search "<query>" --user-id <uid> [OPTIONS]
PropTypeDefaultDescription
QUERY?str (positional)—Semantic search query. Required.
--user-id?str—User ID to search within. Required.
--limit?int10Maximum number of results.
--threshold?floatnoneOptional similarity threshold. Omit to use the server default.
Terminal
reflexio user-profiles search "dietary preferences" --user-id user_123 --limit 5

Command: reflexio user-profiles add

Manually add a profile, bypassing interaction-based inference. Useful for seeding known facts during testing or migration.

Terminal
reflexio user-profiles add --user-id <uid> --content "<text>"
PropTypeDefaultDescription
--user-id?str—User the profile belongs to. Required.
--content?str—Profile text. Used as the embedding source for semantic search. Required.
Terminal
reflexio user-profiles add \
  --user-id user_123 \
  --content "Prefers non-stop flights in the morning"

Command: reflexio user-profiles regenerate

Re-run the profile inference pipeline over a user's existing interactions. Useful after a prompt or extractor change.

Terminal
reflexio user-profiles regenerate --user-id <uid> [--wait]
PropTypeDefaultDescription
--user-id?str—User ID to regenerate. Required.
--wait?flagfalseBlock until regeneration completes. Without this, returns immediately after queuing.
Terminal
reflexio user-profiles regenerate --user-id user_123 --wait

Command: reflexio user-profiles delete

Delete a specific profile, or all profiles for a single user when --profile-id is omitted.

Terminal
reflexio user-profiles delete --user-id <uid> [--profile-id <pid>]
PropTypeDefaultDescription
--user-id?str—User ID owning the profile. Required.
--profile-id?str""Specific profile ID to delete. Omit to delete every profile for the user.

Command: reflexio user-profiles delete-all

Delete every profile across all users. Prompts for confirmation unless --yes is set.

Terminal
reflexio user-profiles delete-all [--yes]
PropTypeDefaultDescription
--yes / -y?flagfalseSkip the interactive confirmation prompt.

Irreversible. Consider running reflexio user-profiles delete --user-id <uid> for a single user first.