Servers & Variables
Server Configuration
The servers array defines base URLs for your API. Use variables to make URLs dynamic for different environments, versions, or regions.
Key Concepts
- • url - Base URL for the API
- • description - Human-readable name
- • variables - Dynamic parts with defaults and allowed values
Basic Server Definition
Define one or more static server URLs. The first is the default.
Multiple Environments
In Tigrister
All defined servers appear in the server dropdown. Switch between them instantly when testing endpoints in Area Mode or Preview.
Server Variables
DynamicUse {variable} syntax to create dynamic URL parts. Variables can have defaults and constrained values.
Environment Variable
Multiple Variables
Combine multiple variables for complex URL patterns.
Region + Version
Resulting URLs
Port Variable
Useful for local development with different port configurations.
Note
Port values must be strings in YAML (quoted or unquoted, depending on context). Unquoted 8080 works, but '8080' is safer.
Free-Form Variables
Variables without enum allow any value. Useful for tenant IDs or user-defined subdomains.
Tenant-Based URL
Operation-Level Servers
OverrideOverride global servers for specific paths or operations. Useful when some endpoints are hosted elsewhere.
Environment Integration
TigristerTigrister's environment system works alongside OpenAPI servers. Use environments for runtime values, servers for spec-defined bases.
OpenAPI Servers
- • Defined in the spec
- • Available in dropdown
- • Variables with enum constraints
- • Shared across export
Tigrister Environments
- • Runtime variable storage
- • Secrets (tokens, keys)
- • Per-request overrides
- • Not exported to spec
Best Practice
Define your known server URLs in the spec. Use Tigrister environments for sensitive values (API keys, tokens) that shouldn't be in the spec.
Tigrister Server Features
AutoTigrister provides automatic conversions and intelligent handling for server configurations.
Variable Syntax Conversion
OpenAPI uses {var} syntax. Tigrister automatically converts this to {{var}} for environment variable substitution.
Secret Auto-Detection
Variables with "secret" in their description are automatically marked as secret in Tigrister environments, hiding values in the UI.
Environment ID Persistence
Tigrister uses x-tigrister-env-id andx-tigrister-env-name extensions to preserve environment identities across import/export cycles.
Visual Designer
The Servers section in Visual Designer provides:
- • Add/remove servers with one click
- • Edit URL and description inline
- • View variable values (e.g.,
environment=api) - • Empty state with quick-add button