{
  "operationId": "createEnvironment",
  "method": "PUT",
  "path": "/applications/{applicationFamily}/environments/{environmentName}",
  "summary": "Create a New Environment",
  "requestExamples": [
    {
      "contentType": "application/json",
      "name": "CreateenvironmentRequestExample",
      "example": {
        "environmentType": "Production",
        "countryCode": "example_value",
        "ringName": "example_value",
        "applicationVersion": "example_value"
      }
    }
  ],
  "responseExamples": [
    {
      "status": "201",
      "contentType": "application/json",
      "name": "Createenvironment201Example",
      "example": {
        "friendlyName": "example_value",
        "type": "Production",
        "name": "Example Title",
        "countryCode": "example_value",
        "applicationFamily": "example_value",
        "aadTenantId": "500123",
        "status": "NotReady",
        "webClientLoginUrl": "https://www.example.com",
        "webServiceUrl": "https://www.example.com",
        "locationName": "example_value",
        "geoName": "example_value",
        "ringName": "example_value",
        "appInsightsKey": "example_value",
        "softDeletedOn": "2026-01-15T10:30:00Z",
        "hardDeletePendingOn": "2026-01-15T10:30:00Z",
        "deleteReason": "example_value",
        "appSourceAppsUpdateCadence": "example_value",
        "versionDetails": {
          "version": "example_value",
          "gracePeriodStartDate": "2026-01-15T10:30:00Z",
          "enforcedUpdatePeriodStartDate": "2026-01-15T10:30:00Z"
        }
      }
    },
    {
      "status": "202",
      "contentType": "application/json",
      "name": "Createenvironment202Example",
      "example": {
        "id": "abc123",
        "type": "create",
        "status": "Queued",
        "aadTenantId": "500123",
        "createdOn": "2026-01-15T10:30:00Z",
        "startedOn": "2026-01-15T10:30:00Z",
        "completedOn": "2026-01-15T10:30:00Z",
        "createdBy": "example_value",
        "errorMessage": "example_value",
        "parameters": "example_value",
        "environmentName": "example_value",
        "environmentType": "example_value",
        "productFamily": "example_value"
      }
    },
    {
      "status": "400",
      "contentType": "application/json",
      "name": "Createenvironment400Example",
      "example": {
        "code": "example_value",
        "message": "example_value",
        "target": "example_value",
        "extensionData": "example_value",
        "clientError": [
          {
            "code": "example_value",
            "message": "example_value",
            "target": "example_value",
            "extensionData": "example_value",
            "clientError": {}
          }
        ]
      }
    },
    {
      "status": "409",
      "contentType": "application/json",
      "name": "Createenvironment409Example",
      "example": {
        "code": "example_value",
        "message": "example_value",
        "target": "example_value",
        "extensionData": "example_value",
        "clientError": [
          {
            "code": "example_value",
            "message": "example_value",
            "target": "example_value",
            "extensionData": "example_value",
            "clientError": {}
          }
        ]
      }
    }
  ]
}