Tigrister Extensions
Custom OpenAPI Extensions
Tigrister uses vendor extensions (x-tigrister-*) to store application-specific data in your OpenAPI spec. These extensions enable features like test assertions, auth configurations, and project metadata.
Key Concepts
- • OpenAPI Compliant - All x-* extensions are valid per spec
- • Round-Trip Safe - Extensions survive import/export cycles
- • Sync Aware - Preserved during bi-directional sync
Available Extensions
Tigrister defines the following vendor extensions:
| Extension | Location | Purpose |
|---|---|---|
| x-tigrister-assertions | Operation | Test assertions for responses |
| x-tigrister-auth | Operation | Per-endpoint auth configuration |
| x-tigrister-enabled | Parameter | Enable/disable individual parameters |
| x-tigrister-env-id | Server | Stable environment identifier |
| x-tigrister-env-name | Server | Custom environment display name |
| x-tigrister-project-id | Root | Project tracking ID |
| x-tigrister-version | Root | Tigrister format version |
| x-tigrister-module-id | Tag | Module/folder identifier |
| x-tigrister-endpoint-id | Operation | Endpoint tracking ID |
x-tigrister-assertions
TestingDefine test assertions that run automatically when you send a request. Assertions verify response status, headers, body content, and more.
Full Example
Assertion Types
- status - HTTP status code
- response_time - Response time in ms
- header - Header value check
- json_path - JSON path validation
- body - Raw body content
Comparison Operators
- equals / not_equals
- contains / not_contains
- exists / not_exists
- greater_than / less_than
- is_empty / is_not_empty
- matches_regex / is_type
x-tigrister-auth
AuthOverride the authentication method for specific operations. Useful when an endpoint needs different auth than the global security setting.
Bearer Token Override
API Key Override
Basic Auth Override
No Auth (Public)
Security Note
Auth credentials in x-tigrister-auth are stored in your spec file. Use environment variables or exclude this extension when sharing specs externally.
x-tigrister-enabled
ParameterEnable or disable individual parameters. Useful for temporarily turning off specific query params or headers without removing them from the spec.
enabled: true (default)
Parameter is included when sending requests.
enabled: false
Parameter is skipped when sending requests. Still visible in UI.
Environment Extensions
ServerControl how servers map to Tigrister environments with stable IDs and custom display names.
x-tigrister-env-id & x-tigrister-env-name
x-tigrister-env-id
Stable identifier for the environment. Preserves selection across re-imports even if URL or description changes.
x-tigrister-env-name
Display name in the UI. Takes precedence over the server'sdescription field.
Project Metadata
TrackingInternal tracking extensions added by Tigrister for project management. Generally you don't need to edit these manually.
Auto-Generated IDs
Project, module, and endpoint IDs are generated automatically by Tigrister. They enable stable sync between spec and project even when names change.
Round-Trip Fidelity
Tigrister preserves your extensions through the import → edit → export cycle:
Extensions you didn't touch remain exactly as imported. Tigrister only modifies sections you actually edit.
Preservation Guarantee
Unknown vendor extensions (x-*) from other tools are also preserved. Tigrister only manages its own x-tigrister-* namespace.