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 the end users that have stored state 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. See Environments.
--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 prints state JSON to stdout, or a message to stderr when no state exists for the user.

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>