This reference documents every command and flag of epx. The same text is in epx <command> --help. Command-line client for the Emporix Commerce APIs. Credentials are read from the environment:
Where none of these is set, a profile (epx profile add) gives them, its client secret from the OS keychain: the profile that --profile names, else EPX_PROFILE, else the default profile (epx profile use). The two never mix, and naming a profile while one is set is a usage error. --tenant overrides the tenant of either. A profile’s default site and language apply where a command needs a site or shows translations and the flag is not given, on the profile’s tenant. Exit codes: 0 success, 1 error, 2 invalid usage or configuration, 3 authentication or missing scopes, 4 not found, 5 conflict: a write that Emporix answered with 409 Conflict, as when the item changed since it was read or exists already, or a units update or catalogs patch with metadata.version answered with 404 Not Found, as the Unit and Catalog services answer a stale version. A 403 Forbidden that the help of a command calls a refusal of its input exits 1.

Global flags

Every command takes these flags.
  • -h, --help
    Help for epx.
  • --profile <name>
    Profile to use (default from EPX_PROFILE, else the default profile).
  • --tenant <string>
    Emporix tenant (default from EMPORIX_TENANT, else the profile).
  • --timeout <duration>
    Timeout for each HTTP request. Default: 30s.

Commands