Make ids and timestamps#
A reference that starts with a dollar sign produces a fresh value on every send.
Some values should be different every time you send: a fresh unique id, the current time, a random number. Dynamic variables generate these on the spot. They look like ordinary variables but start with a dollar sign. API Client works out each one at send time. It does not read the value from an environment.
Write a dynamic variable#
Write a dynamic variable as {{$name}}. Each occurrence resolves on its own, so two {{$guid}} references in one request produce two different ids. API Client resolves dynamic variables after your ordinary variables, and you can use both in the same request.
The values you can use#
| Reference | What it produces |
|---|---|
{{$guid}} | A random UUID. |
{{$randomUUID}} | A random UUID, the same as {{$guid}}. |
{{$timestamp}} | The current Unix time in seconds. |
{{$isoTimestamp}} | The current time as an ISO 8601 string. |
{{$randomInt}} | A random whole number from 0 to 1000. |
An unknown {{$name}} stays in place as literal text, the same as an unset ordinary variable.
When to use them#
Reach for a dynamic variable whenever a request needs to be unique or current, for example an idempotency key on a header (Idempotency-Key: {{$guid}}), a cache-busting query parameter, or a timestamp in a signed payload. API Client computes them fresh each time, so you never have to change them between sends.