Create an environment

View as Markdown
Creates an environment. **Note:** - The request body size cannot exceed the maximum allowed size of 30MB. - If you receive an HTTP `411 Length Required` error response, manually pass the `Content-Length` header and its value in the request header. - If you do not include the `workspace` query parameter, the system creates the environment in the oldest personal Internal workspace you own. - Only [shared variable](https://learning.postman.com/docs/use/send-requests/variables/variables/#share-variable-values) values can be modified through the Postman API. A shared variable is an environment variable with its value synced and stored in the Postman cloud, and can be accessed by your teammates in the environment's workspace.

Authentication

x-api-keystring
API Key authentication via header

Query parameters

workspacestringRequired
The workspace's ID.

Request

This endpoint expects an object.
environmentobjectOptional
Information about the environment.

Response

Successful Response
environmentobject
Information about the environment.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
411
Length Required Error
413
Content Too Large Error
500
Internal Server Error