Skip to main content

Profile

The photon profile commands manage your Photon developer or organization profile.

View your profile

Displays your account details and profile information.

Create a profile

Walks you through an interactive prompt to create a developer or organization profile. You can also pass flags directly for non-interactive use.

Update your profile

Updates specific fields on your existing profile. The available flags differ based on whether you have a developer or organization profile. Aliases: profile edit.

Utility commands

ping

Test connectivity to the Photon API:
Hits the /api/health endpoint and prints the response. Useful for verifying that the backend is reachable and your network configuration is correct. You can also ping an arbitrary URL directly (bypasses credential resolution):

env

Print the currently resolved backend:
Useful for confirming which backend your commands will target, especially when using PHOTON_API_HOST.

whoami

Show the authenticated user for the current backend:
Prints your user ID, email, and name. Returns an error with a login hint if your session has expired.

auth status

Show login state across all backends you’ve authenticated against:
Lists each backend with its credential status. Flags corrupt or invalid credential files.

config show

Dump the active CLI configuration (no secrets):
Displays the config directory path, current backend, active PHOTON_PROJECT_ID, and relevant environment variable values.