Postman

Postman Environments API

The Environments API enables programmatic management of Postman environments and global variables, including secret variables stored in the Postman Vault, so you can scope work to dev/staging/prod environments.

Documentation GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /environments List environments · Get all environments #

Ask an LLM

“Which environments do I have?”

“Can I list only the environments in a particular workspace?”

Tell an agent

List all my environments.

List the environments in workspace {workspace}.

POST /environments Create an environment · Create an environment #

Ask an LLM

“How do I create a new environment with variables in a workspace?”

“Is there a size limit on the environment I create?”

Tell an agent

Create an environment in workspace {workspace}.

Create environment {environment} in workspace {workspace}.

GET /environments/{environmentId} Get an environment · Get an environment #

Ask an LLM

“How do I see the variables stored in one environment?”

“Can I look up an environment by its ID?”

Tell an agent

Get environment {environmentId}.

Show the variables in environment {environmentId}.

PUT /environments/{environmentId} Replace all of an environment's data · Replace an environment's data #

Ask an LLM

“Can I overwrite an environment completely with new variables?”

“What happens to existing variables when I replace an environment?”

Tell an agent

Replace environment {environmentId} entirely with {environment}.

Overwrite all variables in environment {environmentId}.

DELETE /environments/{environmentId} Delete an environment · Delete an environment #

Ask an LLM

“How do I delete an environment?”

“Can I remove an old environment I no longer use?”

Tell an agent destructive · confirm first

Delete environment {environmentId}.

Remove the environment {environmentId} permanently.

PATCH /environments/{environmentId} Update specific environment variables · Update an environment #

Ask an LLM

“Can I add or change just one variable in an environment without replacing it?”

“Is it possible to add and replace variables in the same patch call?”

Tell an agent

Rename environment {environmentId}.

Add a variable to environment {environmentId} without touching the others.

GET /environments/{environmentId}/forks List an environment's forks · Get an environment's forks #

Ask an LLM

“Who has forked this environment?”

“Can I sort an environment's forks by creation date?”

Tell an agent

List the forks of environment {environmentId}.

Show forks of environment {environmentId} sorted by {sort}.

POST /environments/{environmentId}/forks Fork an environment · Create a fork #

Ask an LLM

“How do I fork an environment into a workspace?”

“Do I need to name an environment fork?”

Tell an agent

Fork environment {environmentId} into workspace {workspaceId} as {forkName}.

Create a fork named {forkName} of environment {environmentId} in {workspaceId}.

POST /environments/{environmentId}/merges Merge a forked environment into its parent · Merge a fork #

Ask an LLM

“How do I merge changes from a forked environment back into the original?”

“Can I delete the fork automatically after merging it?”

Tell an agent

Merge forked environment {source} into parent {environmentId}.

Merge fork {source} into environment {environmentId} and delete the fork ({deleteSource}).

POST /environments/{environmentUid}/pulls Pull parent changes into a forked environment · Pull source changes #

Ask an LLM

“My forked environment is out of date; can I pull the parent's changes into it?”

“How do I update an environment fork from its source?”

Tell an agent

Pull changes from parent environment {source} into fork {environmentUid}.

Update forked environment {environmentUid} from its source {source}.

Postman Environments API

Operations 10

Documentation

Specifications

Schemas & Data

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification