Environment

Create environment

Creates an environment, a container that organizes related resources such as SSH key pairs, virtual machines, and volumes. To create an environment, provide an environment name and a region in the request body. Environment names must be unique within your organization, even across different regions.

post/core/environments

Request

  • Base URL: https://infrahub-api.nexgencloud.com/v1
  • URL: https://infrahub-api.nexgencloud.com/v1/core/environments
  • Auth: API key in header api_key

Request body

namestring required

Name of the environment being created. Environments must have unique names, even across different regions.

regionstring required

Geographic location of the data center where the environment is created. See Regions for the list of supported values.

Response

Environment has been created successfully

statusboolean

Whether the request succeeded.

messagestring

Human-readable description of the result.

Example response

{
  "status": true,
  "message": "Environment example-environment is created successfully",
  "environment": {
    "id": 3287,
    "name": "example-environment",
    "region": "NORWAY-1",
    "created_at": "2026-05-06T16:04:09Z",
    "features": {
      "green_status": "GREEN"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.