Environment

Environment variables store reusable values you can reference in requests across Replay, Automate, and Workflows.

Creating and Editing Variables

1. Open Environment from the left navigation.
2. Click Add variable.
3. Enter a name starting with a letter or underscore, followed by letters, numbers, underscores, or hyphens (maximum 64 characters).
4. Enter the value.
5. Toggle Secret if the value is sensitive (API keys, tokens, passwords). Secret values are masked in the UI and excluded from AI context.
6. Click Save.

To edit an existing variable, click its row and update the name or value.

Using Variables in Requests

Reference an environment variable using the env. prefix:

{{env.VARIABLE_NAME}}

Examples:

• Host field: {{env.TARGET_HOST}} (store a hostname, not a complete URL).
• Authorization header: Bearer {{env.AUTH_TOKEN}}.
• Request body: {"tenant": "{{env.TENANT_ID}}"}; enable body templating in Replay when you want substitutions inside the body.

Ogma resolves valid environment placeholders at send time. A missing variable produces an error rather than silently sending an unresolved value. Raw and Hex Replay sends preserve exact bytes and do not expand placeholders.

Variable Scope

Choose Global for values shared by projects in this Ogma workspace, or Project for values belonging to the active project. Project values override global values with the same name. Replay also supports collection and session overrides; priority is session, collection, project, then global.

Transforms and Dynamic Values

Append transforms with a pipe, for example {{env.AUTH_TOKEN|base64_encode}} or {{env.SEARCH|url_encode}}. The chain applies left to right. Check the output with a test request: unrecognized transform names are skipped, not reported as errors.

Built-in values do not need a saved variable:

Placeholder	Value
{{$timestamp}}	Current Unix time in milliseconds.
{{$timestamp_s}}	Current Unix time in seconds.
{{$uuid}}	A new UUID.
{{$random(16)}}	16 random bytes represented as hexadecimal.
{{$date(%Y-%m-%d)}}	Current UTC date using a date-format pattern.

Stored values are not recursively expanded. If a value contains another placeholder, that nested text stays literal.

AI Assistant Access

The AI assistant can read non-secret variable names and values to provide context when you ask it to analyze a request or draft a test plan. Secret variables are never included in AI context.

Common Uses

Variable	Example value
BASE_URL	https://api.example.com
AUTH_TOKEN	eyJhbGci... (mark as secret)
TARGET_HOST	app.example.com
API_KEY	sk-... (mark as secret)
USER_ID	12345

Related Pages

• Replay
• Automate
• Workflows