Environment & Flow CLI Commands Reference

Environment Commands

maeris env list

Lists all environments for the current application, showing which is currently active.

maeris env list

maeris env create

Creates a new named environment.

maeris env create staging maeris env create production maeris env create local

maeris env rename

Renames an existing environment.

maeris env rename staging "Staging (US-East)"

maeris env delete

Deletes an environment and all its variable data.

maeris env delete old-staging

Environment Data Commands

maeris env data list

Lists all key-value pairs stored in an environment.

maeris env data list staging maeris env data list production

maeris env data add

Adds a new variable to an environment. Use --secret to mark sensitive values.

maeris env data add staging --key base_url --value https://api-staging.example.com maeris env data add staging --key auth_token --value eyJhbGci... --secret maeris env data add production --key base_url --value https://api.example.com

maeris env data update

Updates the value of an existing environment variable.

maeris env data update staging --key base_url --value https://api2-staging.example.com

maeris env data delete

Removes a variable from an environment.

maeris env data delete staging --key old_token

maeris env select

Sets the active environment for all subsequent API runs and flow executions.

maeris env select staging maeris env select production

maeris env current

Shows the name and all variables of the currently active environment.

maeris env current

Flow Commands

maeris flow list

Lists all API flows defined in the current application.

maeris flow list

maeris flow create

Creates a new named API flow.

maeris flow create "User Login Flow" maeris flow create "Checkout Flow"

maeris flow run

Executes a flow, running all steps in the defined sequence using the active environment's variables.

maeris flow run "User Login Flow" maeris flow run "Checkout Flow" --env staging

maeris flow delete

Deletes an API flow and its configuration.

maeris flow delete "Old Flow"

maeris flow map set

Defines the step sequence and dependencies for a flow.

maeris flow map set "User Login Flow" \ --steps "Login,Get Profile,Get Orders" \ --depends "Get Profile:Login,Get Orders:Get Profile"

maeris flow param add

Defines a parameter mapping that extracts a value from one step's response and injects it into a subsequent step's request.

maeris flow param add "User Login Flow" \
  --from-step "Login" \
  --from-path "response.body.access_token" \
  --to-step "Get Profile" \
  --to-location "header" \
  --to-key "Authorization" \
  --to-template "Bearer {{value}}"

Assertion Commands

maeris assertion list

Lists all assertions for a specific API.

maeris assertion list --api "Get User"

maeris assertion create

Creates a new assertion for an API.

maeris assertion create \ --api "Get User" \ --nature response \ --type value \ --path "body.status" \ --value "active" # Performance assertion maeris assertion create \ --api "Get User" \ --nature performance \ --type max_response_time \ --value 500

maeris assertion update

Updates an existing assertion's value or configuration.

maeris assertion update <assertion-id> --value "verified"

maeris assertion delete

Deletes an assertion by its ID.

maeris assertion delete <assertion-id>

Next Steps