A variable can be asked, routed, or never kept at all.
Environments that build on each other, project variables, globals, and four flags that change what a variable is: Secret, Ask, Route and Ephemeral. The id of the person a request is about is asked for at the send; the token another request has to fetch first is routed; the thing that must never be written is not.
Where a value comes from
Written once, with names. Filled at the send, each its own way.
A request is written with names — the host, the customer's id, the token, the key — and the names are filled the moment it goes. Where a value comes from is an order, and the first place that has it wins: a value a script set for this send, the data-file row of the runner's iteration, the active environment through its "Based on" chain, the project's variables, globals. Four flags change how a row is filled at all: a Secret is masked and kept out of the project, an Ask is a form at the send, a Route is another request run first, an Ephemeral is never written anywhere.
Typing {{ opens autocomplete with the values. {{$guid}}, {{$timestamp}}, {{$isoTimestamp}} and {{$randomInt}} work anywhere. A name that resolves to nothing is flagged under the URL before you send.
How a variable is filled is a block of its own in the table.
A row of a project's variables says not only what it is worth but how it comes to be worth it.
Secret: masked, and kept out of the project.
Shown as dots, left out of the project's folder on disk and out of exports. In a shared environment a secret row's name goes to the team store; its value stays on the computer that typed it.
Ask: no value kept. A form at the send.
The person is asked when a request or a flow that reads it runs — as text, a number, yes or no, or a select with its choices. Every send, or once per session.
At every request that uses it, at the requests you pick, or at those and at any other while it has no answer.
Route: a request that fills it, run first.
The row names the request that produces the value — the one that gets the token. When the variable is empty, that request runs first and its script sets it. Nobody has to remember the order.
Ephemeral: never written anywhere.
Filled for the session only. Cleared at start and at a change of environment. What a script sets holds for the session the same way — listed under the table with Keep and Drop.
Shared with the team. Yours on top.
An environment is born Local only or Shared. A shared one travels with the project; what you type over it does not. Staging based on Base, Base based on Defaults: the chain is walked at the send and the nearest row wins, and your own overrides — My values — win over all of it without ever leaving this computer.
Beside it, one send of one request, and where every value of it came from.
secret://vault/path#field: fetched at send from Vault, AWS, Azure, Google, 1Password, Doppler or Infisical, cached in memory, never written. Or secret://sonda/name from the team's own vault.What is written, where, and under what.
Several accounts per computer, several workspaces per account. A workspace is a folder of files, every one of them sealed.