Create an environment
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
workspace
The workspace's ID.
Request
This endpoint expects an object.
environment
Information about the environment.
Response
Successful Response
environment
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