Using Environment Variables

Variables stored via tg.environment.set() (or defined in the Environment Manager) are referenced with {{varName}} syntax. They are resolved at send time in:

Environment Context

The environment that tg.environment reads from and writes to depends on the execution context:

Example: Login Flow with Token Storage

Post-script on a login request:

// Extract token from login response and save to environment
if (tg.response.status === 200) {
  const data = tg.response.json();
  tg.environment.set('auth_token', data.access_token);
  tg.environment.set('refresh_token', data.refresh_token);
  tg.environment.set('user_id', String(data.user.id));
  console.log('Tokens saved to environment');
}

// Now subsequent requests can use:
//   URL: https://{{base_url}}/api/users/{{user_id}}
//   Header: Authorization: Bearer {{auth_token}}

Example: Dynamic Request Modification

Pre-script:

// Add authentication header from environment
const token = tg.environment.get('auth_token');
if (token) {
  tg.request.setHeader('Authorization', 'Bearer ' + token);
}

// Add a unique request ID
tg.request.setHeader('X-Request-Id', crypto.randomUUID());

// Modify URL based on environment
const baseUrl = tg.environment.get('base_url');
if (baseUrl) {
  tg.request.url = baseUrl + '/api/v2/users';
}

// Remove a debug header before sending
tg.request.removeHeader('X-Debug');

Example: Response Inspection and Token Extraction

Post-script:

// Inspect response
console.log('Status:', tg.response.status, tg.response.statusText);

// Parse JSON body (cached — call multiple times safely)
const data = tg.response.json();

// Save extracted values to environment
if (tg.response.status === 200) {
  tg.environment.set('user_id', String(data.id));
  tg.environment.set('session_token', data.token);
}

// Check performance
const timing = tg.response.timing;
if (timing && timing.total > 2000) {
  console.warn('Slow response:', timing.total, 'ms');
}

Using Flow Variables

Variables stored via tg.flow.set() are referenced with {{flow.varName}} syntax. They are injected into subsequent steps at execution time in:

Flow Variables vs Environment Variables

Example: Multi-Step Flow

A 3-step flow: Create User → Get User → Delete User

const data = tg.response.json();
tg.flow.set('userId', String(data.id));
tg.flow.set('username', data.username);
console.log('Created user:', data.id);

1. {{varName}} — Environment variables resolved first

   Checks the active environment (live envContext) → falls back to static environment variables

2. {{flow.varName}} — Flow variables resolved second

   Checks the flow store (tg.flow.set() values) → falls back to extracted variables from previous steps

Example: Mixed Variables

// URL with both env and flow variables:
// {{base_url}}/api/users/{{flow.userId}}/posts
//
// Resolution:
//   {{base_url}}      → from tg.environment → "https://api.example.com"
//   {{flow.userId}}   → from tg.flow        → "42"
//
// Result: https://api.example.com/api/users/42/posts