@ampeco/public-api-mcp 3.99.2 → 3.100.0

package/dist/generated/response-schemas.json

@@ -9159,6 +9159,17 @@
                     "type": "string"
                   }
                 },
+                "uptimeTrackingEnabled": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "When set to true, enables Uptime tracking for the charge point by creating an operational period.\nWhen set to false or omitted, Uptime tracking remains disabled.\n\n**Requirements:**\n- Charge point must be commercial type (public or private)\n- Operator must have operational availability enabled\n\n**Validation Errors:**\n- Returns HTTP 422 if charge point is personal type\n- Returns HTTP 422 if operator has operational availability disabled\n\n**Examples:**\n```json\n{\n  \"name\": \"CP-001\",\n  \"accessType\": \"public\",\n  \"uptimeTrackingEnabled\": true\n}\n```\n\n**Validation Error Examples:**\n\nPersonal charge point error:\n```json\n{\n  \"message\": \"The given data was invalid.\",\n  \"errors\": {\n    \"uptimeTrackingEnabled\": [\n      \"Uptime tracking can only be enabled for commercial charge points\"\n    ]\n  }\n}\n```\n\nOperator settings error:\n```json\n{\n  \"message\": \"The given data was invalid.\",\n  \"errors\": {\n    \"uptimeTrackingEnabled\": [\n      \"Operator must have operational availability enabled to track uptime\"\n    ]\n  }\n}\n```\n"
+                },
+                "uptimeTrackingActivatedAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "The timestamp when Uptime tracking was activated (start of current open operational period).\nOmitted from response if Uptime tracking is not enabled or has never been activated.\nFormat: ISO 8601 with timezone offset.\n\n**Example:**\n`\"2025-10-14T08:30:00+00:00\"` - When uptime tracking is enabled\n\n**Note:** This field is omitted from the response when uptime tracking is disabled or never activated.\n",
+                  "example": "2025-10-14T08:30:00+00:00"
+                },
                 "name": {
                   "type": "string"
                 },
@@ -9695,6 +9706,17 @@
                   "type": "string"
                 }
               },
+              "uptimeTrackingEnabled": {
+                "type": "boolean",
+                "default": false,
+                "description": "When set to true, enables Uptime tracking for the charge point by creating an operational period.\nWhen set to false or omitted, Uptime tracking remains disabled.\n\n**Requirements:**\n- Charge point must be commercial type (public or private)\n- Operator must have operational availability enabled\n\n**Validation Errors:**\n- Returns HTTP 422 if charge point is personal type\n- Returns HTTP 422 if operator has operational availability disabled\n\n**Examples:**\n```json\n{\n  \"name\": \"CP-001\",\n  \"accessType\": \"public\",\n  \"uptimeTrackingEnabled\": true\n}\n```\n\n**Validation Error Examples:**\n\nPersonal charge point error:\n```json\n{\n  \"message\": \"The given data was invalid.\",\n  \"errors\": {\n    \"uptimeTrackingEnabled\": [\n      \"Uptime tracking can only be enabled for commercial charge points\"\n    ]\n  }\n}\n```\n\nOperator settings error:\n```json\n{\n  \"message\": \"The given data was invalid.\",\n  \"errors\": {\n    \"uptimeTrackingEnabled\": [\n      \"Operator must have operational availability enabled to track uptime\"\n    ]\n  }\n}\n```\n"
+              },
+              "uptimeTrackingActivatedAt": {
+                "type": "string",
+                "format": "date-time",
+                "description": "The timestamp when Uptime tracking was activated (start of current open operational period).\nOmitted from response if Uptime tracking is not enabled or has never been activated.\nFormat: ISO 8601 with timezone offset.\n\n**Example:**\n`\"2025-10-14T08:30:00+00:00\"` - When uptime tracking is enabled\n\n**Note:** This field is omitted from the response when uptime tracking is disabled or never activated.\n",
+                "example": "2025-10-14T08:30:00+00:00"
+              },
               "name": {
                 "type": "string"
               },
@@ -10117,6 +10139,17 @@
                   "type": "string"
                 }
               },
+              "uptimeTrackingEnabled": {
+                "type": "boolean",
+                "default": false,
+                "description": "When set to true, enables Uptime tracking for the charge point by creating an operational period.\nWhen set to false or omitted, Uptime tracking remains disabled.\n\n**Requirements:**\n- Charge point must be commercial type (public or private)\n- Operator must have operational availability enabled\n\n**Validation Errors:**\n- Returns HTTP 422 if charge point is personal type\n- Returns HTTP 422 if operator has operational availability disabled\n\n**Examples:**\n```json\n{\n  \"name\": \"CP-001\",\n  \"accessType\": \"public\",\n  \"uptimeTrackingEnabled\": true\n}\n```\n\n**Validation Error Examples:**\n\nPersonal charge point error:\n```json\n{\n  \"message\": \"The given data was invalid.\",\n  \"errors\": {\n    \"uptimeTrackingEnabled\": [\n      \"Uptime tracking can only be enabled for commercial charge points\"\n    ]\n  }\n}\n```\n\nOperator settings error:\n```json\n{\n  \"message\": \"The given data was invalid.\",\n  \"errors\": {\n    \"uptimeTrackingEnabled\": [\n      \"Operator must have operational availability enabled to track uptime\"\n    ]\n  }\n}\n```\n"
+              },
+              "uptimeTrackingActivatedAt": {
+                "type": "string",
+                "format": "date-time",
+                "description": "The timestamp when Uptime tracking was activated (start of current open operational period).\nOmitted from response if Uptime tracking is not enabled or has never been activated.\nFormat: ISO 8601 with timezone offset.\n\n**Example:**\n`\"2025-10-14T08:30:00+00:00\"` - When uptime tracking is enabled\n\n**Note:** This field is omitted from the response when uptime tracking is disabled or never activated.\n",
+                "example": "2025-10-14T08:30:00+00:00"
+              },
               "name": {
                 "type": "string"
               },
@@ -10589,6 +10622,17 @@
               "type": "string"
             }
           },
+          "uptimeTrackingEnabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "When set to true, enables Uptime tracking for the charge point by creating an operational period.\nWhen set to false or omitted, Uptime tracking remains disabled.\n\n**Requirements:**\n- Charge point must be commercial type (public or private)\n- Operator must have operational availability enabled\n\n**Validation Errors:**\n- Returns HTTP 422 if charge point is personal type\n- Returns HTTP 422 if operator has operational availability disabled\n\n**Examples:**\n```json\n{\n  \"name\": \"CP-001\",\n  \"accessType\": \"public\",\n  \"uptimeTrackingEnabled\": true\n}\n```\n\n**Validation Error Examples:**\n\nPersonal charge point error:\n```json\n{\n  \"message\": \"The given data was invalid.\",\n  \"errors\": {\n    \"uptimeTrackingEnabled\": [\n      \"Uptime tracking can only be enabled for commercial charge points\"\n    ]\n  }\n}\n```\n\nOperator settings error:\n```json\n{\n  \"message\": \"The given data was invalid.\",\n  \"errors\": {\n    \"uptimeTrackingEnabled\": [\n      \"Operator must have operational availability enabled to track uptime\"\n    ]\n  }\n}\n```\n"
+          },
+          "uptimeTrackingActivatedAt": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The timestamp when Uptime tracking was activated (start of current open operational period).\nOmitted from response if Uptime tracking is not enabled or has never been activated.\nFormat: ISO 8601 with timezone offset.\n\n**Example:**\n`\"2025-10-14T08:30:00+00:00\"` - When uptime tracking is enabled\n\n**Note:** This field is omitted from the response when uptime tracking is disabled or never activated.\n",
+            "example": "2025-10-14T08:30:00+00:00"
+          },
           "name": {
             "type": "string"
           },
@@ -11656,8 +11700,13 @@
                 },
                 "electricityCostReimbursementIntegrationId": {
                   "type": "integer",
-                  "description": "The ID of the third-party electricity cost reimbursement integration to use for processing reimbursements for charging sessions at this charge point. Only applicable to personal (home) charge points - ignored for public and private charge points.\n",
+                  "description": "The ID of the third-party electricity cost reimbursement integration to use for processing reimbursements for charging sessions at this charge point. Only applicable to personal (home) charge points - ignored for public and private charge points. When not set, this property is omitted from the response.\n",
                   "example": 123
+                },
+                "installationAndMaintenanceCompanyId": {
+                  "type": "integer",
+                  "description": "The ID of the Installation & Maintenance company associated with this charge point. Must be owned by the same operator. When not set, this property is omitted from the response.\n",
+                  "example": 456
                 }
               }
             }
@@ -12249,8 +12298,13 @@
               },
               "electricityCostReimbursementIntegrationId": {
                 "type": "integer",
-                "description": "The ID of the third-party electricity cost reimbursement integration to use for processing reimbursements for charging sessions at this charge point. Only applicable to personal (home) charge points - ignored for public and private charge points.\n",
+                "description": "The ID of the third-party electricity cost reimbursement integration to use for processing reimbursements for charging sessions at this charge point. Only applicable to personal (home) charge points - ignored for public and private charge points. When not set, this property is omitted from the response.\n",
                 "example": 123
+              },
+              "installationAndMaintenanceCompanyId": {
+                "type": "integer",
+                "description": "The ID of the Installation & Maintenance company associated with this charge point. Must be owned by the same operator. When not set, this property is omitted from the response.\n",
+                "example": 456
               }
             }
           }
@@ -12793,8 +12847,13 @@
               },
               "electricityCostReimbursementIntegrationId": {
                 "type": "integer",
-                "description": "The ID of the third-party electricity cost reimbursement integration to use for processing reimbursements for charging sessions at this charge point. Only applicable to personal (home) charge points - ignored for public and private charge points.\n",
+                "description": "The ID of the third-party electricity cost reimbursement integration to use for processing reimbursements for charging sessions at this charge point. Only applicable to personal (home) charge points - ignored for public and private charge points. When not set, this property is omitted from the response.\n",
                 "example": 123
+              },
+              "installationAndMaintenanceCompanyId": {
+                "type": "integer",
+                "description": "The ID of the Installation & Maintenance company associated with this charge point. Must be owned by the same operator. When not set, this property is omitted from the response.\n",
+                "example": 456
               }
             }
           }
@@ -13380,8 +13439,13 @@
               },
               "electricityCostReimbursementIntegrationId": {
                 "type": "integer",
-                "description": "The ID of the third-party electricity cost reimbursement integration to use for processing reimbursements for charging sessions at this charge point. Only applicable to personal (home) charge points - ignored for public and private charge points.\n",
+                "description": "The ID of the third-party electricity cost reimbursement integration to use for processing reimbursements for charging sessions at this charge point. Only applicable to personal (home) charge points - ignored for public and private charge points. When not set, this property is omitted from the response.\n",
                 "example": 123
+              },
+              "installationAndMaintenanceCompanyId": {
+                "type": "integer",
+                "description": "The ID of the Installation & Maintenance company associated with this charge point. Must be owned by the same operator. When not set, this property is omitted from the response.\n",
+                "example": 456
               }
             }
           }
@@ -13554,55 +13618,6 @@
                     }
                   }
                 },
-                {
-                  "type": "object",
-                  "properties": {
-                    "name": {
-                      "type": "string",
-                      "example": "Energi Elspot"
-                    },
-                    "integrationId": {
-                      "type": "integer",
-                      "nullable": true,
-                      "example": 150
-                    },
-                    "type": {
-                      "type": "string",
-                      "enum": [
-                        "energi_elspot"
-                      ]
-                    },
-                    "defaults": {
-                      "type": "object",
-                      "properties": {
-                        "target_charge": {
-                          "type": "object",
-                          "properties": {
-                            "departure_time": {
-                              "type": "string",
-                              "format": "time",
-                              "example": "01:00",
-                              "description": "The 24-hour format should be used.</br>\nExample `00:00`\n"
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "locations": {
-                      "type": "object",
-                      "properties": {
-                        "key": {
-                          "type": "string",
-                          "example": "DK1"
-                        },
-                        "label": {
-                          "type": "string",
-                          "example": "West Denmark"
-                        }
-                      }
-                    }
-                  }
-                },
                 {
                   "type": "object",
                   "properties": {
@@ -17071,66 +17086,6 @@
                   }
                 }
               },
-              {
-                "title": "Energi Elspot",
-                "type": "object",
-                "required": [
-                  "type"
-                ],
-                "properties": {
-                  "enabled": {
-                    "type": "boolean",
-                    "default": true,
-                    "description": "Enable or disable the smart charging from owner preferences\n"
-                  },
-                  "type": {
-                    "type": "string",
-                    "enum": [
-                      "energi_elspot"
-                    ]
-                  },
-                  "integrationId": {
-                    "type": "integer"
-                  },
-                  "preferences": {
-                    "type": "object",
-                    "required": [
-                      "location",
-                      "targetCharge"
-                    ],
-                    "properties": {
-                      "location": {
-                        "type": "string",
-                        "enum": [
-                          "GB1"
-                        ],
-                        "description": "The price region based on energi elspot prices api"
-                      },
-                      "targetCharge": {
-                        "type": "object",
-                        "required": [
-                          "departureTime",
-                          "targetChargeKwh"
-                        ],
-                        "properties": {
-                          "departureTime": {
-                            "type": "string",
-                            "format": "time"
-                          },
-                          "preconditioningTime": {
-                            "type": "integer",
-                            "description": "The time in minutes before departure when the charging will be performed with full power."
-                          },
-                          "targetChargeKwh": {
-                            "type": "number",
-                            "example": 10
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
-              },
               {
                 "title": "NordPool",
                 "type": "object",
@@ -17164,7 +17119,7 @@
                         "enum": [
                           "GB1"
                         ],
-                        "description": "The price region based on energi elspot prices api"
+                        "description": "The price region based on NordPool prices"
                       },
                       "targetCharge": {
                         "type": "object",
@@ -17312,7 +17267,6 @@
                 "solar": "#/components/schemas/PersonalSmartChargingPreferencesSolar",
                 "octopus_agile": "#/components/schemas/PersonalSmartChargingPreferencesOctopusAgile",
                 "octopus_go": "#/components/schemas/PersonalSmartChargingPreferencesOctopusGo",
-                "energi_elspot": "#/components/schemas/PersonalSmartChargingPreferencesEnergiElspot",
                 "nordpool": "#/components/schemas/PersonalSmartChargingPreferencesNordPool",
                 "charger_electricity_rate": "#/components/schemas/PersonalSmartChargingPreferencesChargerElectricityRate"
               }
@@ -17654,66 +17608,6 @@
                   }
                 }
               },
-              {
-                "title": "Energi Elspot",
-                "type": "object",
-                "required": [
-                  "type"
-                ],
-                "properties": {
-                  "enabled": {
-                    "type": "boolean",
-                    "default": true,
-                    "description": "Enable or disable the smart charging from owner preferences\n"
-                  },
-                  "type": {
-                    "type": "string",
-                    "enum": [
-                      "energi_elspot"
-                    ]
-                  },
-                  "integrationId": {
-                    "type": "integer"
-                  },
-                  "preferences": {
-                    "type": "object",
-                    "required": [
-                      "location",
-                      "targetCharge"
-                    ],
-                    "properties": {
-                      "location": {
-                        "type": "string",
-                        "enum": [
-                          "GB1"
-                        ],
-                        "description": "The price region based on energi elspot prices api"
-                      },
-                      "targetCharge": {
-                        "type": "object",
-                        "required": [
-                          "departureTime",
-                          "targetChargeKwh"
-                        ],
-                        "properties": {
-                          "departureTime": {
-                            "type": "string",
-                            "format": "time"
-                          },
-                          "preconditioningTime": {
-                            "type": "integer",
-                            "description": "The time in minutes before departure when the charging will be performed with full power."
-                          },
-                          "targetChargeKwh": {
-                            "type": "number",
-                            "example": 10
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
-              },
               {
                 "title": "NordPool",
                 "type": "object",
@@ -17747,7 +17641,7 @@
                         "enum": [
                           "GB1"
                         ],
-                        "description": "The price region based on energi elspot prices api"
+                        "description": "The price region based on NordPool prices"
                       },
                       "targetCharge": {
                         "type": "object",
@@ -26933,7 +26827,6 @@
                     "admin_defined",
                     "octopus_go",
                     "agile_octopus",
-                    "elspot",
                     "nord_pool"
                   ]
                 }
@@ -27061,7 +26954,6 @@
                   "admin_defined",
                   "octopus_go",
                   "agile_octopus",
-                  "elspot",
                   "nord_pool"
                 ]
               }
@@ -27140,7 +27032,6 @@
                   "admin_defined",
                   "octopus_go",
                   "agile_octopus",
-                  "elspot",
                   "nord_pool"
                 ]
               }
@@ -27262,7 +27153,6 @@
                   "admin_defined",
                   "octopus_go",
                   "agile_octopus",
-                  "elspot",
                   "nord_pool"
                 ]
               }
@@ -34177,19 +34067,7 @@
                 "integrationParameters": {
                   "type": "object",
                   "description": "Flexibility integration parameters.",
-                  "additionalProperties": {
-                    "type": "string",
-                    "nullable": true
-                  },
-                  "example": {
-                    "meterId": "123456789",
-                    "meterSerialNumber": "123456789",
-                    "transformerId": "123456789",
-                    "priceZone": "123456789",
-                    "latitude": "123.45",
-                    "longitude": "123.45",
-                    "dso": "dso"
-                  }
+                  "additionalProperties": true
                 },
                 "status": {
                   "type": "string",
@@ -34351,19 +34229,7 @@
               "integrationParameters": {
                 "type": "object",
                 "description": "Flexibility integration parameters.",
-                "additionalProperties": {
-                  "type": "string",
-                  "nullable": true
-                },
-                "example": {
-                  "meterId": "123456789",
-                  "meterSerialNumber": "123456789",
-                  "transformerId": "123456789",
-                  "priceZone": "123456789",
-                  "latitude": "123.45",
-                  "longitude": "123.45",
-                  "dso": "dso"
-                }
+                "additionalProperties": true
               },
               "status": {
                 "type": "string",
@@ -34476,19 +34342,7 @@
               "integrationParameters": {
                 "type": "object",
                 "description": "Flexibility integration parameters.",
-                "additionalProperties": {
-                  "type": "string",
-                  "nullable": true
-                },
-                "example": {
-                  "meterId": "123456789",
-                  "meterSerialNumber": "123456789",
-                  "transformerId": "123456789",
-                  "priceZone": "123456789",
-                  "latitude": "123.45",
-                  "longitude": "123.45",
-                  "dso": "dso"
-                }
+                "additionalProperties": true
               },
               "status": {
                 "type": "string",
@@ -34644,19 +34498,7 @@
               "integrationParameters": {
                 "type": "object",
                 "description": "Flexibility integration parameters.",
-                "additionalProperties": {
-                  "type": "string",
-                  "nullable": true
-                },
-                "example": {
-                  "meterId": "123456789",
-                  "meterSerialNumber": "123456789",
-                  "transformerId": "123456789",
-                  "priceZone": "123456789",
-                  "latitude": "123.45",
-                  "longitude": "123.45",
-                  "dso": "dso"
-                }
+                "additionalProperties": true
               },
               "status": {
                 "type": "string",
@@ -45988,6 +45830,11 @@
                 "autoRenewal": {
                   "type": "boolean"
                 },
+                "externalId": {
+                  "type": "string",
+                  "description": "Used to store custom information, usually used for external references or metadata to the resource.",
+                  "maxLength": 255
+                },
                 "accessAndPermissions": {
                   "type": "object",
                   "properties": {
@@ -46102,6 +45949,7 @@
                 }
               },
               "required": [
+                "id",
                 "title",
                 "partnerId",
                 "startDate"
@@ -46288,6 +46136,11 @@
               "autoRenewal": {
                 "type": "boolean"
               },
+              "externalId": {
+                "type": "string",
+                "description": "Used to store custom information, usually used for external references or metadata to the resource.",
+                "maxLength": 255
+              },
               "accessAndPermissions": {
                 "type": "object",
                 "properties": {
@@ -46402,6 +46255,7 @@
               }
             },
             "required": [
+              "id",
               "title",
               "partnerId",
               "startDate"
@@ -46474,6 +46328,11 @@
               "autoRenewal": {
                 "type": "boolean"
               },
+              "externalId": {
+                "type": "string",
+                "description": "Used to store custom information, usually used for external references or metadata to the resource.",
+                "maxLength": 255
+              },
               "accessAndPermissions": {
                 "type": "object",
                 "properties": {
@@ -46588,6 +46447,7 @@
               }
             },
             "required": [
+              "id",
               "title",
               "partnerId",
               "startDate"
@@ -46670,6 +46530,11 @@
               "autoRenewal": {
                 "type": "boolean"
               },
+              "externalId": {
+                "type": "string",
+                "description": "Used to store custom information, usually used for external references or metadata to the resource.",
+                "maxLength": 255
+              },
               "accessAndPermissions": {
                 "type": "object",
                 "properties": {
@@ -46784,6 +46649,7 @@
               }
             },
             "required": [
+              "id",
               "title",
               "partnerId",
               "startDate"