Skip to content

sky state user

Inspect and delete end-user state as a developer.

Synopsis

bash
sky state user list --project <slug> [--env <slug>] [--limit <n>] [--cursor <cursor>]
sky state user show --project <slug> --user <user-id> [--env <slug>]
sky state user delete --project <slug> --user <user-id> [--yes]

Description

These commands use the developer bearer session from sky login. They do not use project API keys.

list returns end users who have user-state rows in one environment. show prints one user's state for one environment. delete removes all state for one external user across all environments in the project.

Options

OptionCommandsDescription
--project <slug>allRequired. Project slug.
--env <slug>list, showEnvironment. Resolved from SKYSTATE_ENV or default_env when omitted.
--limit <n>listMaximum number of results. Default is 50.
--cursor <cursor>listPagination cursor from the previous response.
--user <user-id>show, deleteRequired. External user ID.
--yesdeleteSkip confirmation. Required for non-interactive deletion.

Global --format is supported by list. plain prints one external user ID per line. show always prints state JSON to stdout.

Examples

bash
sky state user list --project my-app --env production
sky state user list --project my-app --env production --limit 25
sky state user list --project my-app --env production --cursor <cursor>
sky state user show --project my-app --env production --user user_123
sky state user delete --project my-app --user user_123 --yes

When another page is available, list prints the next-page hint to stderr:

text
Next page: --cursor <cursor>