Skip to content

Environments

Switch between sets of variables (dev, staging, production) without editing individual requests.

How It Works

An environment is a named collection of key-value variables. When you send a request, the backend substitutes any {{variable_name}} placeholders in the URL, headers, and body with the values from the active environment.

URL:    {{base_url}}/users/{{user_id}}
Header: Authorization: Bearer {{api_token}}

If the active environment has base_url = https://api.example.com, user_id = 42, and api_token = sk_abc123, the outgoing request becomes:

GET https://api.example.com/users/42
Authorization: Bearer sk_abc123

Managing Environments

Manage Environments dialog

Open the Manage Environments dialog from the Environments page (or the environment selector in the header).

Sidebar actions:

  • New Environment - creates an empty environment
  • Import - load an environment from a JSON file

Per-environment actions (buttons in the environment header):

  • Set Active / Deactivate - choose which environment supplies variable values
  • Duplicate - copy an environment with all its variables
  • Export - download the environment as a JSON file
  • Delete - remove the environment (with confirmation)
  • Rename - double-click the environment name to edit it

Variables

Each variable has:

FieldDescription
KeyThe name you reference with {{key}}
ValueThe substituted value
EnabledToggle - disabled variables are skipped during substitution
SecretToggle - masks the value in the UI (eye icon to reveal)

Add variables in the editor table. Click the + row to add a new one, or remove with the trash icon.

Variable editor table

Variable Autocomplete

The VariableAwareInput fields throughout the app (URL bar, header values, etc.) show an autocomplete dropdown when you start typing a variable reference. It lists all variables from the active environment so you can pick the right name.

Variable autocomplete

Switching Environments

Use the environment selector dropdown in the header bar. Selecting a different environment changes which variables are substituted - you don't need to edit any requests.

Environment selector dropdown

Where Variables Are Substituted

The backend replaces {{variable}} placeholders in:

  • Request URL
  • Header values
  • Request body

Substitution is a single pass - variables cannot reference other variables (no nesting).

Variable names are case-sensitive: {{api_key}} and {{API_KEY}} are different variables.

Released under the MIT License.