@ampeco/public-api-mcp 3.259.1 → 3.260.0

package/dist/generated/build-stats.json

@@ -1,13 +1,13 @@
 {
   "totalEndpoints": 686,
-  "originalSize": 6612313,
-  "optimizedSize": 1849798,
-  "reductionPercent": 72.02,
-  "buildDuration": 1568,
+  "originalSize": 6626711,
+  "optimizedSize": 1863124,
+  "reductionPercent": 71.88,
+  "buildDuration": 2595,
   "responseSchemas": {
     "total": 686,
     "withSchemas": 686,
-    "totalSchemaSize": 3802765,
-    "averageSchemaSize": 5543
+    "totalSchemaSize": 3803561,
+    "averageSchemaSize": 5545
   }
 }

package/dist/generated/endpoints.json

@@ -8397,11 +8397,13 @@
                     },
                     "saslUsername": {
                       "type": "string",
-                      "nullable": true
+                      "nullable": true,
+                      "description": "Required when securityProtocol is SASL_SSL."
                     },
                     "saslPassword": {
                       "type": "string",
-                      "nullable": true
+                      "nullable": true,
+                      "description": "Required when securityProtocol is SASL_SSL."
                     }
                   },
                   "required": [
@@ -8636,11 +8638,13 @@
                     },
                     "saslUsername": {
                       "type": "string",
-                      "nullable": true
+                      "nullable": true,
+                      "description": "Required when securityProtocol is SASL_SSL."
                     },
                     "saslPassword": {
                       "type": "string",
-                      "nullable": true
+                      "nullable": true,
+                      "description": "Required when securityProtocol is SASL_SSL."
                     }
                   },
                   "required": [
@@ -8783,9 +8787,6 @@
         "401": {
           "description": "Client authentication failed."
         },
-        "404": {
-          "description": "The OAuth token revocation endpoint is not enabled on this tenant."
-        },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
         }
@@ -8871,9 +8872,6 @@
         "401": {
           "description": "Client authentication failed."
         },
-        "404": {
-          "description": "The OAuth token exchange endpoint is not enabled on this tenant."
-        },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
         }
@@ -8955,7 +8953,7 @@
       "method": "GET",
       "operationId": "adminRead",
       "summary": "Admin / Read",
-      "description": "Get administrator details by ID. Returns administrator information including organizational context (if applicable), role, and optionally permissions. **Admin types:** The admin type can be determined by which optional ID field is present: - `partnerId` - Admin belongs to a partner organization - `subOperatorId` - Admin belongs to a sub-operator organization - `installationAndMaintenanceCompanyId` - Admin belongs to an I&M company - None of the above - Operator-level administrator **SSO field:** The `externalSsoId` field is present when the administrator has SSO authentication enabled. **Permissions include:** Use `?include[]=permissions` to include the administrator's permissions in the response.",
+      "description": "Get administrator details by ID. Returns administrator information including organizational context (if applicable), role, and optionally permissions. **Admin types:** The admin type can be determined by which optional ID field is present: - `partnerId` - Admin belongs to a partner organization - `subOperatorId` - Admin belongs to a sub-operator organization - `installationAndMaintenanceCompanyId` - Admin belongs to an I&M company - None of the above - Operator-level administrator **SSO field:** The `externalSsoId` field is present when the administrator has SSO authentication enabled. **Permissions include:** Use `?include[]=permissions` to include the administrator's permissions in the response. For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / admins"
       ],
@@ -8981,6 +8979,9 @@
         "401": {
           "description": "Access token is missing or invalid"
         },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
         "404": {
           "description": "The record is not found"
         },
@@ -8994,7 +8995,7 @@
       "method": "GET",
       "operationId": "adminPermissions",
       "summary": "Admin / Permissions",
-      "description": "Get administrator permissions. Returns a list of permission names assigned to the administrator. This is an alternative to using `?include[]=permissions` on the admin read endpoint.",
+      "description": "Get administrator permissions. Returns a list of permission names assigned to the administrator. This is an alternative to using `?include[]=permissions` on the admin read endpoint. For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / admins"
       ],
@@ -9005,6 +9006,9 @@
         "401": {
           "description": "Access token is missing or invalid"
         },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
         "404": {
           "description": "The record is not found"
         },
@@ -9057,6 +9061,7 @@
       "method": "GET",
       "operationId": "authorizationReadDeprecated",
       "summary": "Authorization / Read",
+      "description": "For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "deprecated": true,
       "tags": [
         "resource / authorizations"
@@ -9197,7 +9202,7 @@
       "method": "GET",
       "operationId": "authorizationRead",
       "summary": "Authorization / Read",
-      "description": "**Deprecated:** Use v2.1 endpoint instead. This endpoint does not distinguish between RFID and MAC address (Autocharge) authorizations - both return `id_tag` as the method.",
+      "description": "**Deprecated:** Use v2.1 endpoint instead. This endpoint does not distinguish between RFID and MAC address (Autocharge) authorizations - both return `id_tag` as the method. For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "deprecated": true,
       "tags": [
         "resource / authorizations"
@@ -9337,6 +9342,7 @@
       "method": "GET",
       "operationId": "authorizationReadV2_1",
       "summary": "Authorization / Read",
+      "description": "For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / authorizations"
       ],
@@ -20718,7 +20724,7 @@
       "method": "GET",
       "operationId": "electricityRateReadDeprecated",
       "summary": "Electricity rate / Read",
-      "description": "Get a single Electricity rate",
+      "description": "Get a single Electricity rate For a partner API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "deprecated": true,
       "tags": [
         "resource / electricity rates"
@@ -21142,7 +21148,7 @@
       "method": "GET",
       "operationId": "electricityRateRead",
       "summary": "Electricity rate / Read",
-      "description": "Get a single Electricity rate",
+      "description": "Get a single Electricity rate For a partner API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / electricity rates"
       ],
@@ -21287,7 +21293,7 @@
       "method": "GET",
       "operationId": "electricityRateEnergyMixRead",
       "summary": "Electricity rate / Energy Mix / Read",
-      "description": "Get an electricity rate energy mix",
+      "description": "Get an electricity rate energy mix For a partner API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / electricity rates"
       ],
@@ -21427,7 +21433,7 @@
       "method": "GET",
       "operationId": "electricityRatePricePeriodsListing",
       "summary": "Electricity rate / Price periods / Listing",
-      "description": "List all of the configured price period days (including week days and dates)",
+      "description": "List all of the configured price period days (including week days and dates) For a partner API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / electricity rates"
       ],
@@ -21466,7 +21472,7 @@
       "method": "GET",
       "operationId": "electricityRatePricePeriodsDateListing",
       "summary": "Electricity rate / Price periods / Date / Listing",
-      "description": "List all of the configured price period dates",
+      "description": "List all of the configured price period dates For a partner API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / electricity rates"
       ],
@@ -21505,7 +21511,7 @@
       "method": "GET",
       "operationId": "electricityRatePricePeriodsDateRead",
       "summary": "Electricity rate / Price periods / Date / Read",
-      "description": "Get the price periods for a specific date.",
+      "description": "Get the price periods for a specific date. For a partner API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / electricity rates"
       ],
@@ -21690,7 +21696,7 @@
       "method": "GET",
       "operationId": "electricityRatePricePeriodsWeekDayListing",
       "summary": "Electricity rate / Price periods / Week day / Listing",
-      "description": "List all of the configured price period week days",
+      "description": "List all of the configured price period week days For a partner API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / electricity rates"
       ],
@@ -21729,7 +21735,7 @@
       "method": "GET",
       "operationId": "electricityRatePricePeriodsWeekDayRead",
       "summary": "Electricity rate / Price periods / Week day / Read",
-      "description": "Get the price periods for a specific week day.",
+      "description": "Get the price periods for a specific week day. For a partner API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / electricity rates"
       ],
@@ -27173,7 +27179,7 @@
       "method": "GET",
       "operationId": "idTagRead",
       "summary": "Id Tag / Read",
-      "description": "Get a Id Tag",
+      "description": "Get a Id Tag For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / id tags"
       ],
@@ -27364,7 +27370,7 @@
       "method": "GET",
       "operationId": "idTagNotesListing",
       "summary": "ID tag / Notes / Listing",
-      "description": "List all notes for a specific ID tag. Notes are returned with pinned notes first, then ordered by ID descending. **Required permission:** `Notes.view`",
+      "description": "List all notes for a specific ID tag. Notes are returned with pinned notes first, then ordered by ID descending. **Required permission:** `Notes.view` For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / id tags"
       ],
@@ -27505,7 +27511,7 @@
       "method": "GET",
       "operationId": "idTagNoteRead",
       "summary": "ID tag / Note / Read",
-      "description": "Get a specific note for an ID tag. **Required permission:** `Notes.view`",
+      "description": "Get a specific note for an ID tag. **Required permission:** `Notes.view` For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / id tags"
       ],
@@ -38855,7 +38861,7 @@
       "method": "DELETE",
       "operationId": "partnerInviteCorporateBillingPolicyDelete",
       "summary": "Partner invite corporate billing policy / Delete",
-      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Delete a partner invite corporate billing policy. Deletion is rejected while the policy is assigned to pending or accepted partner invites.",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Delete a partner invite corporate billing policy. Deletion is rejected while the policy is assigned to pending, sent or accepted partner invites.",
       "tags": [
         "resource / partner invite corporate billing policies"
       ],
@@ -40067,7 +40073,7 @@
       "method": "GET",
       "operationId": "partnerInviteRead",
       "summary": "Partner Invite / Read",
-      "description": "**This endpoint is deprecated. Use `resources/partner-invites/v2.0` instead.** Get a invite",
+      "description": "**This endpoint is deprecated. Use `resources/partner-invites/v2.0` instead.** Get a invite For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "deprecated": true,
       "tags": [
         "resource / partner invites"
@@ -40090,6 +40096,9 @@
         "403": {
           "description": "You do not have permission to perform the action"
         },
+        "404": {
+          "description": "The record is not found"
+        },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
         }
@@ -40495,7 +40504,7 @@
       "method": "GET",
       "operationId": "partnerInviteReadV2_0",
       "summary": "Partner invite / Read",
-      "description": "Get a partner invite. **Experimental endpoint — not yet a stable contract.** `partner-invites/v2.0` ships as **experimental / beta**. While experimental, its schema and behaviour may change **without a version bump — including breaking changes within `v2.0` itself**. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.",
+      "description": "Get a partner invite. **Experimental endpoint — not yet a stable contract.** `partner-invites/v2.0` ships as **experimental / beta**. While experimental, its schema and behaviour may change **without a version bump — including breaking changes within `v2.0` itself**. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / partner invites"
       ],
@@ -41200,7 +41209,7 @@
       "method": "GET",
       "operationId": "partnerSettlementReportRead",
       "summary": "Partner Settlement Report / Read",
-      "description": "**This endpoint is deprecated. Use the v1.1 equivalent instead.** Get a single Partner Settlement Report",
+      "description": "**This endpoint is deprecated. Use the v1.1 equivalent instead.** Get a single Partner Settlement Report For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "deprecated": true,
       "tags": [
         "resource / partner settlement reports"
@@ -41236,7 +41245,7 @@
       "method": "GET",
       "operationId": "partnerSettlementReportPartnerSettlementRecordsListing",
       "summary": "Partner Settlement Report / Partner Settlement Records / Listing",
-      "description": "**This endpoint is deprecated. Use the v1.1 equivalent instead.** Get all Partner Settlement Records",
+      "description": "**This endpoint is deprecated. Use the v1.1 equivalent instead.** Get all partner settlement records. For partner and sub-operator tokens, a report outside the token's visibility returns `404`, as does a missing report, regardless of the dynamic-permissions setting. A visible report without the required read permission returns `403`.",
       "deprecated": true,
       "tags": [
         "resource / partner settlement reports"
@@ -41357,7 +41366,7 @@
       "method": "GET",
       "operationId": "partnertSettlementReportPartnerSettlementRecordRead",
       "summary": "Partner Settlement Report / Partner Settlement Record / Read",
-      "description": "**This endpoint is deprecated. Use the v1.1 equivalent instead.** Read Partner Settlement Record",
+      "description": "**This endpoint is deprecated. Use the v1.1 equivalent instead.** Read Partner Settlement Record For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "deprecated": true,
       "tags": [
         "resource / partner settlement reports"
@@ -41590,7 +41599,7 @@
       "method": "GET",
       "operationId": "partnerSettlementReportReadV1_1",
       "summary": "Partner Settlement Report / Read",
-      "description": "Get a single Partner Settlement Report",
+      "description": "Get a single Partner Settlement Report For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / partner settlement reports"
       ],
@@ -41625,7 +41634,7 @@
       "method": "GET",
       "operationId": "partnerSettlementReportPartnerSettlementRecordsListingV1_1",
       "summary": "Partner Settlement Report / Partner Settlement Records / Listing",
-      "description": "Get all Partner Settlement Records",
+      "description": "Get all partner settlement records. For partner and sub-operator tokens, a report outside the token's visibility returns `404`, as does a missing report, regardless of the dynamic-permissions setting. A visible report without the required read permission returns `403`.",
       "tags": [
         "resource / partner settlement reports"
       ],
@@ -41744,7 +41753,7 @@
       "method": "GET",
       "operationId": "partnerSettlementReportPartnerSettlementRecordReadV1_1",
       "summary": "Partner Settlement Report / Partner Settlement Record / Read",
-      "description": "Read Partner Settlement Record",
+      "description": "Read Partner Settlement Record For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / partner settlement reports"
       ],
@@ -42673,7 +42682,7 @@
       "method": "GET",
       "operationId": "partnerReadDeprecated",
       "summary": "Partner / Read",
-      "description": "Get a partner",
+      "description": "Get a partner For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "deprecated": true,
       "tags": [
         "resource / partners"
@@ -44514,7 +44523,7 @@
       "method": "GET",
       "operationId": "partnerRead",
       "summary": "Partner / Read",
-      "description": "Get a partner",
+      "description": "Get a partner For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / partners"
       ],
@@ -45575,7 +45584,7 @@
       "method": "GET",
       "operationId": "partnerAdminsListing",
       "summary": "Partner / Admins / Listing",
-      "description": "List all administrators for a specific partner. Only partner and partnerSiteManager admin types are returned. **Required permission:** `Admins.view`",
+      "description": "List all administrators for a specific partner. Only partner and partnerSiteManager admin types are returned. **Required permission:** `Admins.view` For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / partners"
       ],
@@ -46202,7 +46211,7 @@
       "method": "GET",
       "operationId": "partnerNotesListing",
       "summary": "Partner / Notes / Listing",
-      "description": "List all notes for a specific partner. Notes are returned with pinned notes first, then ordered by creation date descending. **Required permission:** `Notes.view`",
+      "description": "List all notes for a specific partner. Notes are returned with pinned notes first, then ordered by creation date descending. **Required permission:** `Notes.view` For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / partners"
       ],
@@ -46343,7 +46352,7 @@
       "method": "GET",
       "operationId": "partnerNoteShow",
       "summary": "Partner / Note / Read",
-      "description": "Get a specific note for a partner. **Required permission:** `Notes.view`",
+      "description": "Get a specific note for a partner. **Required permission:** `Notes.view` For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / partners"
       ],
@@ -52412,7 +52421,7 @@
       "method": "GET",
       "operationId": "reservationRead",
       "summary": "Reservation / Read",
-      "description": "Get information for a reservation by ID",
+      "description": "Get information for a reservation by ID For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / reservations"
       ],
@@ -52613,7 +52622,7 @@
       "method": "GET",
       "operationId": "rfidTagReadDeprecated",
       "summary": "RFID Tag / Read",
-      "description": "**Deprecated:** Use `/resources/id-tags/v2.0/{idTag}` instead. Get a RFID Tag",
+      "description": "**Deprecated:** Use `/resources/id-tags/v2.0/{idTag}` instead. Get a RFID Tag For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "deprecated": true,
       "tags": [
         "resource / rfids"
@@ -55199,6 +55208,7 @@
       "method": "GET",
       "operationId": "sessionRead",
       "summary": "Session / Read",
+      "description": "For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / sessions"
       ],
@@ -55292,7 +55302,7 @@
       "method": "GET",
       "operationId": "sessionsConsumptionStatsRead",
       "summary": "Sessions / Consumption Stats / Read",
-      "description": "Consumption statistics may differ between active and finished sessions, as finished sessions display aggregated final data with a maximum of 300 items.",
+      "description": "Consumption statistics may differ between active and finished sessions, as finished sessions display aggregated final data with a maximum of 300 items. For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / sessions"
       ],
@@ -55328,7 +55338,7 @@
       "method": "GET",
       "operationId": "energyCouponSessionConsumptionsListing",
       "summary": "Session / Energy coupon session consumptions",
-      "description": "List the energy coupons consumed during a charging session, with the energy consumed from each.",
+      "description": "List the energy coupons consumed during a charging session, with the energy consumed from each. For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / sessions"
       ],
@@ -55364,7 +55374,7 @@
       "method": "GET",
       "operationId": "sessionTimelineSnapshotRead",
       "summary": "Sessions / Timeline Snapshot / Read",
-      "description": "Returns the meter value time-series and lifecycle events for a finished charging session. **Availability.** Snapshots are generated when a session completes. Active sessions return 404. Finished sessions without snapshots, including sessions that finished before snapshot generation was available, also return 404. There is no historical backfill. Confirmed transaction boundary events are included only in snapshots generated after those event types became available; existing snapshots are not modified. A boundary event is omitted when its timestamp or precise meter reading is unavailable. **For active sessions**, use `GET /logs/communication/v1.0?filter[sessionId]={id}&filter[command]=MeterValues` to read real-time OCPP meter values from communication logs (6-month retention).",
+      "description": "Returns the meter value time-series and lifecycle events for a finished charging session. **Availability.** Snapshots are generated when a session completes. Active sessions return 404. Finished sessions without snapshots, including sessions that finished before snapshot generation was available, also return 404. There is no historical backfill. Confirmed transaction boundary events are included only in snapshots generated after those event types became available; existing snapshots are not modified. A boundary event is omitted when its timestamp or precise meter reading is unavailable. **For active sessions**, use `GET /logs/communication/v1.0?filter[sessionId]={id}&filter[command]=MeterValues` to read real-time OCPP meter values from communication logs (6-month retention). For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / sessions"
       ],
@@ -55581,7 +55591,7 @@
       "method": "GET",
       "operationId": "subOperatorReadDeprecated",
       "summary": "Sub operator / Read",
-      "description": "**Deprecated.** Use v2.0 endpoint instead for enhanced functionality.",
+      "description": "**Deprecated.** Use v2.0 endpoint instead for enhanced functionality. For a sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "deprecated": true,
       "tags": [
         "resource / sub operators"
@@ -56385,7 +56395,7 @@
       "method": "GET",
       "operationId": "subOperatorRead",
       "summary": "Sub-operators / Read",
-      "description": "Get a single sub-operator",
+      "description": "Get a single sub-operator For a sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / sub operators"
       ],
@@ -57126,7 +57136,7 @@
       "method": "GET",
       "operationId": "subOperatorNotesListing",
       "summary": "Sub Operator / Notes / Listing",
-      "description": "List all notes for a specific sub-operator. Notes are returned with pinned notes first, then ordered by creation date descending. **Required permission:** `Notes.view`",
+      "description": "List all notes for a specific sub-operator. Notes are returned with pinned notes first, then ordered by creation date descending. **Required permission:** `Notes.view` For a sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / sub operators"
       ],
@@ -57267,7 +57277,7 @@
       "method": "GET",
       "operationId": "subOperatorNoteShow",
       "summary": "Sub Operator / Note / Read",
-      "description": "Get a specific note for a sub-operator. **Required permission:** `Notes.view`",
+      "description": "Get a specific note for a sub-operator. **Required permission:** `Notes.view` For a sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / sub operators"
       ],
@@ -59516,7 +59526,7 @@
       "method": "GET",
       "operationId": "tariffGroupRead",
       "summary": "Tariff Group / Read",
-      "description": "Get a tariff group",
+      "description": "Get a tariff group For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / tariffs"
       ],
@@ -60914,7 +60924,7 @@
       "method": "GET",
       "operationId": "tariffRead",
       "summary": "Tariff / Read",
-      "description": "Get a tariff",
+      "description": "Get a tariff For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / tariffs"
       ],
@@ -63215,7 +63225,7 @@
       "method": "GET",
       "operationId": "tariffScheduledChangesListing",
       "summary": "Tariff / Scheduled Changes / Listing",
-      "description": "Get all scheduled pricing changes for a tariff",
+      "description": "Get all scheduled pricing changes for a tariff For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / tariffs"
       ],
@@ -64187,7 +64197,7 @@
       "method": "GET",
       "operationId": "tariffScheduledChangeRead",
       "summary": "Tariff / Scheduled Change / Read",
-      "description": "Get a single scheduled pricing change",
+      "description": "Get a single scheduled pricing change For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / tariffs"
       ],
@@ -66863,7 +66873,7 @@
       "method": "GET",
       "operationId": "transactionRead",
       "summary": "Transaction / Read",
-      "description": "Get a transation",
+      "description": "Get a transation For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / transactions"
       ],
@@ -68332,7 +68342,7 @@
       "method": "GET",
       "operationId": "userRead",
       "summary": "User / Read",
-      "description": "Get a user",
+      "description": "Get a user For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "deprecated": true,
       "tags": [
         "resource / users"
@@ -71209,7 +71219,7 @@
       "method": "GET",
       "operationId": "subscriptionBillingPeriodsListing",
       "summary": "Subscription billing periods / Listing",
-      "description": "Get all subscription billing periods for a user",
+      "description": "Get all subscription billing periods for a user For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / users"
       ],
@@ -71305,7 +71315,7 @@
       "method": "GET",
       "operationId": "subscriptionBillingPeriodRead",
       "summary": "Subscription billing period / Read",
-      "description": "Get information for a subscription billing period by ID",
+      "description": "Get information for a subscription billing period by ID For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / users"
       ],
@@ -72346,7 +72356,7 @@
       "method": "GET",
       "operationId": "userReadV1_1",
       "summary": "User / Read",
-      "description": "Get a user",
+      "description": "Get a user For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / users"
       ],
@@ -73257,7 +73267,7 @@
       "method": "GET",
       "operationId": "userNotesListing",
       "summary": "User / Notes / Listing",
-      "description": "List all notes for a specific user. Notes are returned with pinned notes first, then ordered by creation date descending. **Required permission:** `Notes.view`",
+      "description": "List all notes for a specific user. Notes are returned with pinned notes first, then ordered by creation date descending. **Required permission:** `Notes.view` For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / users"
       ],
@@ -73398,7 +73408,7 @@
       "method": "GET",
       "operationId": "userNoteShow",
       "summary": "User / Note / Read",
-      "description": "Get a specific note for a user. **Required permission:** `Notes.view`",
+      "description": "Get a specific note for a user. **Required permission:** `Notes.view` For a partner or sub-operator API token, this endpoint returns `404 Not Found` if the requested resource or its parent is outside the token's scope. If the target is visible to the token but the token lacks the required read permission, it returns `403 Forbidden`.",
       "tags": [
         "resource / users"
       ],
@@ -75334,7 +75344,7 @@
   ],
   "info": {
     "title": "Public API",
-    "version": "3.259.1",
+    "version": "3.260.0",
     "description": "The Public API provides server-to-server integration capabilities for your EV charging platform.\n\n**Authentication.** Existing integrations continue to work unchanged — long-lived UUID admin tokens are sent in `Authorization: Bearer ...` with no exchange required. Two security schemes are documented for OpenAPI client tooling, both resulting in the same Bearer header at the wire level:\n   - `bearerAuth` — the token in the `Authorization: Bearer ...` header is either a long-lived UUID admin token (issued via the admin UI, used directly) or a short-lived access token previously obtained via OAuth.\n   - `oauth2ClientCredentials` - a `client_id` / `client_secret` pair should be exchanged for a short-lived access token at `/public-api/oauth/token` per RFC 6749 Section 4.4 (Client Credentials Grant), and the short-lived token should be used in the `Authorization: Bearer ...` header. The OAuth `client_secret` itself cannot be sent directly as a bearer token — it must be exchanged first.\n"
   },
   "servers": [
@@ -75348,18 +75358,18 @@
       }
     }
   ],
-  "buildTimestamp": "2026-10-07T10:03:23.841Z",
+  "buildTimestamp": "2026-10-07T10:47:09.087Z",
   "stats": {
     "totalEndpoints": 686,
-    "originalSize": 6612313,
-    "optimizedSize": 1849798,
-    "reductionPercent": 72.02,
-    "buildDuration": 1568,
+    "originalSize": 6626711,
+    "optimizedSize": 1863124,
+    "reductionPercent": 71.88,
+    "buildDuration": 2595,
     "responseSchemas": {
       "total": 686,
       "withSchemas": 686,
-      "totalSchemaSize": 3802765,
-      "averageSchemaSize": 5543
+      "totalSchemaSize": 3803561,
+      "averageSchemaSize": 5545
     }
   }
 }

package/dist/generated/response-schemas.json

@@ -26589,11 +26589,13 @@
                     },
                     "saslUsername": {
                       "type": "string",
-                      "nullable": true
+                      "nullable": true,
+                      "description": "Required when securityProtocol is SASL_SSL."
                     },
                     "saslPassword": {
                       "type": "string",
-                      "nullable": true
+                      "nullable": true,
+                      "description": "Required when securityProtocol is SASL_SSL."
                     }
                   },
                   "required": [
@@ -26857,11 +26859,13 @@
                   },
                   "saslUsername": {
                     "type": "string",
-                    "nullable": true
+                    "nullable": true,
+                    "description": "Required when securityProtocol is SASL_SSL."
                   },
                   "saslPassword": {
                     "type": "string",
-                    "nullable": true
+                    "nullable": true,
+                    "description": "Required when securityProtocol is SASL_SSL."
                   }
                 },
                 "required": [
@@ -27098,11 +27102,13 @@
                   },
                   "saslUsername": {
                     "type": "string",
-                    "nullable": true
+                    "nullable": true,
+                    "description": "Required when securityProtocol is SASL_SSL."
                   },
                   "saslPassword": {
                     "type": "string",
-                    "nullable": true
+                    "nullable": true,
+                    "description": "Required when securityProtocol is SASL_SSL."
                   }
                 },
                 "required": [
@@ -27327,11 +27333,13 @@
                   },
                   "saslUsername": {
                     "type": "string",
-                    "nullable": true
+                    "nullable": true,
+                    "description": "Required when securityProtocol is SASL_SSL."
                   },
                   "saslPassword": {
                     "type": "string",
-                    "nullable": true
+                    "nullable": true,
+                    "description": "Required when securityProtocol is SASL_SSL."
                   }
                 },
                 "required": [
@@ -27847,6 +27855,17 @@
         }
       }
     },
+    "403": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string",
+            "default": "This action is unauthorized."
+          }
+        }
+      }
+    },
     "404": {
       "schema": {
         "type": "object",
@@ -27898,6 +27917,17 @@
         }
       }
     },
+    "403": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string",
+            "default": "This action is unauthorized."
+          }
+        }
+      }
+    },
     "404": {
       "schema": {
         "type": "object",
@@ -103214,6 +103244,16 @@
         }
       }
     },
+    "404": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
     "429": {
       "schema": {
         "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampeco/public-api-mcp",
-  "version": "3.259.1",
+  "version": "3.260.0",
   "description": "MCP server that dynamically exposes the AMPECO.CHARGE Public API defined by an OpenAPI 3 specification",
   "type": "module",
   "main": "dist/cli/index.js",