HomeGuidesAPI ReferenceChangelog
Terms of Use
Changelog
Terms of Use
Back to All

3.184.0 release notes

30 minutes ago by ReadMe API
  1. ⚠️ Breaking changes
    1. The parkingType and facilities request fields on Location create/update endpoints no longer accept the UNKNOWN value. Requests that submit UNKNOWN for either field will now fail validation.
  2. ✨ New features
    1. Added POST /public-api/actions/users/v1.0/{user}/subscribe-to-plan. Admins can subscribe a user to a subscription plan, optionally specifying a paymentMethodId; the body also requires planId and reason.
    2. Added GET /public-api/resources/user-devices/v1.0 and GET /public-api/resources/user-devices/v1.0/USERDEVICE for listing and retrieving user push-notification devices. The collection endpoint supports filtering by userId, deviceIdentifier, operatorId, and hasUser.
    3. Added the optional capabilityOverrides property to EVSE create, update, and read endpoints (POST/PATCH/GET /public-api/resources/charge-points/v2.0/{chargePoint}/evses[/{evse}] and POST/PATCH/GET /public-api/resources/evses/v2.1[/{evse}]). Each sub-property (rfidReader, creditCardPayable, contactlessCardSupport, debitCardPayable, chipCardSupport, pedTerminal, remoteStartStop, unlockCapable, reservable, chargingProfileCapable, chargingPreferencesCapable, startSessionConnectorRequired, tokenGroupCapable) lets you manually override the corresponding capability flag for that EVSE.
    4. Added the optional externalId property to Subscription Plan endpoints (POST /public-api/resources/subscription-plans/v2.0, PATCH /public-api/resources/subscription-plans/v2.0/{subscriptionPlan}, and the matching GET endpoints). GET /public-api/resources/subscription-plans/v2.0 also accepts externalId as an exact-match query filter.
    5. Added preAuthorizedAmount and incrementalPreAuthorizationEnabled to the Session response on GET /public-api/resources/sessions/v1.0 and GET /public-api/resources/sessions/v1.0/{session}. preAuthorizedAmount is returned when a pre-authorized amount is available; incrementalPreAuthorizationEnabled indicates whether incremental pre-authorization is active for the session.
    6. Added incremental pre-authorization support to Tariffs. Tariff create/update endpoints (POST /public-api/resources/tariffs/v1.0, PATCH/PUT /public-api/resources/tariffs/v1.0/{tariff}) accept the optional pricing.incrementalPreAuthorizationAmount and restrictions.adHocIncrementalPreAuthorizationAmount properties. Tariff responses now include those fields plus a top-level incrementalPreAuthorizationSupported flag. The same pricing.incrementalPreAuthorizationAmount and restrictions.adHocIncrementalPreAuthorizationAmount fields are exposed on GET /public-api/resources/tariff-snapshots/v1.0/{tariffSnapshot}.
    7. Added lastUpdatedAfter and lastUpdatedBefore query filters to GET /public-api/resources/tariffs/v1.0 and GET /public-api/resources/electricity-meters/v1.0.
    8. Added the new blocked enum value to the occupancyStatus property on Parking Space create/update endpoints and to the status property on POST /public-api/actions/parking-spaces/v1.0/{parkingSpace}/update-occupancy-status. blocked can also be returned in Parking Space responses.
    9. Added a documented 422 response to GET /public-api/resources/electricity-meters/v1.0 and GET /public-api/resources/tariffs/v1.0 for requests with invalid filter parameters.
  3. 🔧 Improvements
    1. Location and Location Image responses now omit parkingType, facilities entries, and image category when their underlying value is UNKNOWN, instead of returning a literal UNKNOWN/unknown string.
    2. Expanded the response enum for connector type on Charge Point connector and EVSE endpoints to include unknown, used as a fallback when the connector type cannot be mapped to a known value.
    3. The 429 response on POST /public-api/actions/charge-point/v1.0/{chargePoint}/start/{evse} and POST /public-api/actions/evse/v1.0/{evse}/start now always returns a message field describing why the request was rate-limited.