Upcoming Breaking API Changes
All upcoming breaking changes to the API are listed below, ordered by the effective date of the change.
2026/06/15 - Attendances permission changes
The permissions structure for attendances is being updated. Currently, attendances permissions are part of both the relations and enrollments permission hierarchies. This will change so that attendances permissions are only part of the enrollments hierarchy.
| Permission affected | Current location | New location |
|---|---|---|
| Attendances permissions | Relations and Enrollments hierarchies | Enrollments hierarchy |
Migration recommendations
Review and update your API scope and user role configurations to ensure attendances permissions are properly set after the change takes effect. If you currently rely on attendances permissions through the relations hierarchy, you will need to ensure appropriate enrollments permissions are configured.
Viewing attendances will require enrollments:read permissions, while managing attendances will require enrollments:modify permissions after the change.
TBD - Get personal program elements endpoint removal
The following endpoints/methods are deprecated and planned for removal:
| Endpoint | Method |
|---|---|
/api/v1/program/personal_program_elements | GET |
TBD - Affiliations endpoints removal
The following endpoints/methods are deprecated and planned for removal:
| Endpoint | Method |
|---|---|
/api/v1/affiliations | GET |
/api/v1/affiliations | POST |
/api/v1/affiliations/{id} | PATCH |
/api/v1/affiliations/{id} | DELETE |
Migration recommendations
Once the organization change is live for your Eduframe environment1, switch from /api/v1/affiliations to /api/v1/organization_affiliations to ensure accurate user-organization relationships.
TBD - Accounts endpoint changes
The following endpoint including all of its methods are planned for change of use:
| Endpoint | Originally used for | Will be used for |
|---|---|---|
/api/v1/accounts | Organizations & organization invoice address data | Invoice addresses |
Migration recommendations
Once the organization change is live for your Eduframe environment1 and you need:
- Organizations, use
/api/v1/organizationsinstead. - Invoice address details of an organization, get the
primary_account_idfor an organization and retrieve the primary account using/api/v1/accounts/{id}instead.
Want to prepare for the organization change? The feature can be activated on any test environment on request.
For further details, refer to the API documentation or contact Eduframe support.