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

3.279.0 release notes

about 4 hours ago by ReadMe API
  1. ⚠️ Breaking changes
    1. Changed authorization on GET /public-api/resources/users/v1.0/{user}/payment-methods/{paymentMethodId} to require payment method viewing access for all valid identifiers, including corporate, subscription installment, wallet and bank transfer identifiers. Requests without this access are now rejected.
  2. ✨ New features
    1. Added GET /public-api/resources/churn-events/v1.0 to list churn events with cursor pagination. Supported filters include filter[subjectType], filter[exitType], filter[churnReasonId], filter[segment], filter[partnerId], filter[occurredFrom], filter[occurredTo] and filter[updatedAfter].
    2. Added GET /public-api/resources/usage-states/v1.0 to list usage states for drivers, partners and roaming eMSPs, including activity metrics where available. The endpoint supports cursor pagination and filtering by filter[level], filter[state] and filter[updatedAfter].
    3. Added occurredOn, churnReasonName, setBy, reasonSetBy, recoveredExitIds, createdAt and updatedAt to churn record responses on POST /public-api/actions/churn-record/v1.0/record-exit and POST /public-api/actions/churn-record/v1.0/{churnRecord}/set-reason. These fields provide the event date, reason name, actor details, recovered exit references and timestamps where applicable.
    4. Added energyConsumption.gridImport, energyConsumption.gridExport and energyConsumption.gridNet to session responses on GET /public-api/resources/sessions/v1.0, GET /public-api/resources/sessions/v1.0/{session} and POST /public-api/actions/session/v1.0/{session}/set-custom-fields. Values are in Wh; gridNet is imported energy minus exported energy and can be negative, while gridExport is 0 for sessions without confirmed vehicle-to-grid activity.
    5. Added durationBreakdown.exportDurationSeconds to GET /public-api/resources/sessions/v1.0/{session} to report the total time the vehicle spent exporting energy to the grid.
    6. Added the optional filter[hasExportedEnergy] filter to GET /public-api/resources/sessions/v1.0 to select sessions with or without exported energy. Accepted values are true, false, 1 and 0.
  3. 🔧 Improvements
    1. Expanded the Issues category values with external_services for requests and responses on POST /public-api/resources/issues/v1.0 and PATCH /public-api/resources/issues/v1.0/{issue}, responses on GET /public-api/resources/issues/v1.0/{issue}, and filtering and responses on GET /public-api/resources/issues/v1.0.
  4. 🗑️ Deprecations
    1. Deprecated energyConsumption.grid in session responses on GET /public-api/resources/sessions/v1.0, GET /public-api/resources/sessions/v1.0/{session} and POST /public-api/actions/session/v1.0/{session}/set-custom-fields. Use energyConsumption.gridImport instead; the existing field remains available.