Environments & variables
Environments are named sets of key/value pairs. Variables let you write a request once and switch context (dev, staging, production) without editing every URL.
Syntax
Use double braces in the URL, headers, and body:
{{base_url}}/api/v1/users
{{api_key}}Resolution happens before the request is sent.
Resolution order
When the same name exists in more than one place, the resolution order is:
- Environment variables (active environment) -- highest priority
- Collection variables (from the collection or import)
- Global variables (user-wide defaults) -- lowest priority
That means you can set defaults at the global or collection level and override per environment.
Enable / disable
Each variable can be enabled or disabled without deleting it — useful for optional headers or experimental flags.
Active environment
Use the environment selector in the toolbar (or equivalent) to pick which environment is active. Only one active environment applies at a time.
Global variables
Gud API also supports global variables (user-wide) where the product exposes them — useful for values you want everywhere unless overridden. Behavior may differ slightly by version; check the sidebar for Globals or similar if available.
Related
- Sending requests — where placeholders are applied
- Collections — collection-level variables