Set active

Set active An surroundings is a hard and fast of variables you may use to your Postman requests. You can use environments to institution associated units of values collectively and control get right of entry to to shared Postman statistics in case you are operating as a part of a group.

Creating environments Set active

Postman presentations the lively surroundings withinside the surroundings selector, positioned withinside the pinnacle proper of the workbench.

You can get right of entry to all environments from Environments withinside the sidebar. Select the set lively icon Set lively icon subsequent to an surroundings to make it the lively surroundings.

Environment editor Set active

The surroundings brief appearance icon Quick Look icon is subsequent to the surroundings selector. The brief appearance lists variables for the lively surroundings, and any international variables you’ve got got declared or which are shared to your workspace

Environment brief appearance

To create a brand new surroundings, pick out Environments at the left and pick out +.

Create new surroundings

Enter a call on your surroundings, and initialize it with any variables you need—you may as an alternative specify variables for the surroundings later.

Add Environment

Select Save to keep any surroundings variables you’ve got got added.

Adding surroundings variables

You can upload variables to an lively (presently selected) surroundings via way of means of beginning the surroundings from the sidebar and enhancing it withinside the tab that opens.

Edit surroundings

Edit the variable names and values inline, or use the near icon Close icon to delete a variable. Enter the call and values for a brand new variable on a brand new line. Save while your adjustments are complete.Alternatively, pick out the surroundings brief appearance icon Quick Look icon and edit inline.

Edit Environment

If you’re operating with surroundings variables as a part of a group, you may handiest be capable of extrade preliminary values when you have edit get right of entry to to the surroundings. You can get right of entry to all variables in environments shared with you, however may also have read-handiest get right of entry to to preliminary values when you have a Viewer function.

The Initial Value is synced for your account the use of the Postman servers. It’s shared with any collaborators who’ve get right of entry to to the surroundings.
The Current Value is used to your neighborhood example of Postman, and is by no means synced for your account or shared together along with your group until you pick out to persist it.

To replace the synced variable together along

with your neighborhood cost, set the preliminary cost to the cutting-edge cost via way of means of deciding on the greater movements icon More movements icon and selecting Persist. To reset your neighborhood (cutting-edge) cost with the synced cost shared together along with your workspace / collaborators, pick out Reset. You can persist or reset all values withinside the surroundings the use of Persist All and Reset All.

You also can outline surroundings variables via way of means of Type. Variables are routinely assigned the default kind while created, that is proven as undeniable textual content and has no extra properties. You can extrade touchy variables to mystery kind, which mask the preliminary and cutting-edge values for all workspace members. Secret kind may be used to save you accidental disclosure of touchy statistics, consisting of API secrets, passwords, tokens, and keys.

Accessing environments

You can get right of entry to your surroundings variables from Postman and out of your request elements, consisting of the URL, parameters, frame statistics, and check scripts.

For the listing of all of your environments, pick out Environments withinside the sidebar.

View all environments

Here you may upload, share, duplicate, download, control get right of entry to, delete, and dispose of a shared surroundings from a workspace. You also can get right of entry to your international variables via way of means of deciding on Globals.

To view the variables in an surroundings, pick out its call. You can edit, upload, and dispose of variables from the surroundings here.

Selecting an lively surroundings

To use the variables in an surroundings, pick out it from the surroundings selector on the pinnacle proper of the workbench.

Environment selector

To take a look at a variable cost at a glance, use the surroundings brief appearance icon Quick Look icon .

When you pick out an surroundings the use of the surroundings selector, Postman treats it because the lively surroundings and runs all requests in opposition to that surroundings (in case your requests reference surroundings variables).

To use an surroundings variable cost in a request, reference it via way of means of call, surrounded with double curly braces

You can use the identical variable notation in request URLs, parameters, headers, and frame statistics.

Environment var reference

If a couple of variable with the identical call is to be had to a request, Postman will use the cost from the variable with narrowest scope. This way that when you have an surroundings variable with the identical call as a set or international variable, Postman will use the surroundings variable, however neighborhood and statistics variable values will supersede surroundings values. The cost of any overridden variables will show with a strikethrough.

Overridden cost

You can get right of entry to cutting-edge surroundings variable values to your Pre-request and Tests code.

pm.surroundings.

You can submit environments together along with your API documentation and the Run in Postman button.

Editing surroundings variables

You can edit variables both via way of means of beginning an surroundings from Environments at the left, or via way of means of beginning the surroundings brief appearance icon Quick Look icon on the pinnacle proper of Postman and deciding on Edit.

You will handiest be capable of edit environments in which you’ve got got Editor get right of entry to.

Edit surroundings

Edit the surroundings call, or the names, types, and values of your variables, bearing in thoughts that Initial Values may be synced together along with your Postman account and shared with any collaborators who’ve get right of entry to to the surroundings. Select Save while your edits are complete.

Viewer function on surroundings

If you’ve got got Viewer get right of entry to to an surroundings, a lock icon Lock icon subsequent to the call suggests that it is read-handiest. You will handiest howtowikis. Set active Set active