Skip to main content

Environments

Environments let you manage different configurations for development, staging, and production.

Overview​

Creating an Environment​

  1. Click the Settings icon next to the environment selector
  2. Go to the Environments tab
  3. Click Add Environment
  4. Enter:
    • Name: e.g., "Development"
    • Color: Visual identifier

Switching Environments​

Use the environment dropdown in the header to switch:

  1. Click the current environment name
  2. Select the desired environment
  3. All requests will use the new environment's variables

Environment Variables​

Each environment can have its own variables:

Development​

VariableValue
API_URLhttp://localhost:3000
DEBUGtrue

Staging​

VariableValue
API_URLhttps://staging.example.com
DEBUGtrue

Production​

VariableValue
API_URLhttps://api.example.com
DEBUGfalse

Variable Resolution​

When you use {{API_URL}}:

  1. Check current environment for API_URL
  2. If not found, check global variables
  3. If still not found, leave as {{API_URL}}

Example​

Global: API_URL = https://default.example.com
Development: API_URL = http://localhost:3000
Production: (not set)
Environment{{API_URL}} resolves to
Developmenthttp://localhost:3000
Productionhttps://default.example.com
No environmenthttps://default.example.com

Managing Environments​

Editing​

  1. Go to Environments tab
  2. Click on an environment
  3. Modify name, color, or variables

Duplicating​

Right-click an environment and select Duplicate to create a copy with all variables.

Deleting​

Click the trash icon to remove an environment. This doesn't affect global variables.

Color Coding​

Each environment has a color for quick identification:

  • Development (Green)
  • Staging (Yellow)
  • Production (Red)

The color appears:

  • In the environment selector
  • Next to variable badges in inputs

Workflow Example​

Setup​

  1. Create three environments: Dev, Staging, Prod
  2. Add environment-specific variables:
# Development
API_URL = http://localhost:3000
DATABASE = dev_db

# Staging
API_URL = https://staging.api.com
DATABASE = staging_db

# Production
API_URL = https://api.com
DATABASE = prod_db

Usage​

  1. Develop and test with Development environment
  2. Test integration with Staging environment
  3. Verify production with Production environment

All requests use the same variable names, only values change.

Best Practices​

Consistent Variables

Keep variable names consistent across environments. Only values should differ.

Production Safety

Use distinct colors (red) for production to prevent accidental requests.

Secrets per Environment

Each environment can have different API keys, tokens, etc.

Common Setup​

VariableDevelopmentStagingProduction
API_URLlocalhost:3000staging.api.comapi.com
DEBUGtruetruefalse
LOG_LEVELdebuginfoerror
API_KEYdev-keystg-keyprod-key