profile
Manage store profiles. A profile is a per-store context (store, store token, and scopes) under your logged-in account, so you can work with several stores without re-authenticating. auth login --store-domain and auth store use create and switch profiles automatically.
To run one command against another profile without switching, pass the global --profile <name> flag or set SHOPLAZZA_CLI_PROFILE. --profile wins over the environment variable, which wins over the current profile.
At an interactive terminal, add asks for a missing name and store, use, rename, and remove let you pick the profile, and remove asks you to confirm.
add
Add a named profile bound to a store, minting and caching its store token. Requires an account login first (shoplazza auth login).
shoplazza profile add [flags]
Flags
| Flag | Type | Description |
|---|---|---|
--name <name> | string | Profile name (required) |
--store-domain, -s <domain> | string | Store domain to bind this profile to (e.g. my-store.myshoplaza.com) (required) |
--scope <scopes> | StringSlice | Scopes for this profile (must be a subset of the account's granted scopes); empty grants the account's full scope set |
--use | bool | Set this profile as current after adding it |
Examples
# Add a profile for a store
shoplazza profile add --name prod --store-domain my-store.myshoplaza.com
# Add a scoped profile and switch to it
shoplazza profile add --name staging --store-domain staging.myshoplaza.com --scope read_product --use
list
List all configured profiles with their store, scopes, token status, and which one is current.
shoplazza profile list
info
Show a profile's details (defaults to the current profile).
shoplazza profile info [flags]
Flags
| Flag | Type | Description |
|---|---|---|
--name <name> | string | Profile to show (defaults to the current profile) |
use
Switch the current profile to a named one, or back to the previously-current profile.
shoplazza profile use [flags]
Flags
| Flag | Type | Description |
|---|---|---|
--name <name> | string | Profile to switch to |
--previous | bool | Switch back to the previously-current profile |
Examples
# Switch to a named profile
shoplazza profile use --name prod
# Switch back to the previous profile
shoplazza profile use --previous
# Run one command against another profile without switching
shoplazza products list --profile prod
update
Update a profile's scopes. The cached store token is dropped and minted again with the new scopes on the next command.
shoplazza profile update [flags]
Flags
| Flag | Type | Description |
|---|---|---|
--name <name> | string | Profile to update (defaults to the current profile) |
--scope <scopes> | StringSlice | New scopes for this profile (must be a subset of the account's granted scopes) |
rename
Rename a profile.
shoplazza profile rename [flags]
Flags
| Flag | Type | Description |
|---|---|---|
--from <name> | string | Existing profile name (defaults to the current profile) |
--to <name> | string | New profile name (required) |
remove
Remove a profile: its cached store token and config record. Your account login is kept.
shoplazza profile remove [flags]
Flags
| Flag | Type | Description |
|---|---|---|
--name <name> | string | Profile to remove (required) |