Skip to content
MILES Knowledge Base

API Deprecations

Here you can find everything currently deprecated in the MILES GraphQL API — and what has been removed in the past.

The authoritative source is the schema itself: every deprecated symbol carries an @deprecated marker, and your tooling can pick those up automatically. This page shows the same information in a human-readable form.

How removals are handled is described in the deprecation policy.

Need more time?

In general, we recommend migrating promptly. If that doesn’t work out for a specific deprecation, send us an email!

Currently deprecated

Section titled “Currently deprecated”
  • Enum value ActivityType.COURSE
    The course concept no longer exists. See ActivityType.COURSE_MODULE instead.
  • Field Appointment.endDateString
    Use startDate and endDate instead
  • Field Appointment.startDateString
    Use startDate and endDate instead
  • Argument filter on FineObjectiveEdges.exerciseRevisions
    not used in client and not necessary
  • Argument filter on LearningPhaseEdges.exerciseRevisions
    not used in client and not necessary
  • Operation onAssessmentUpdate
    use onAssessmentChanged instead. removal after 2026-11-20.
  • Operation onContentBlockRevisionUpdate
    use onContentBlockRevisionChanged instead. removal after 2026-11-20.
  • Operation onContentUnitRevisionUpdate
    use onContentUnitRevisionChanged instead. removal after 2026-11-20.
  • Operation onCourseModuleRevisionUpdate
    use onCourseModuleRevisionChanged instead. removal after 2026-11-20.
  • Operation onExerciseRevisionUpdate
    use onExerciseRevisionChanged instead. removal after 2026-11-20.
  • Operation onFineObjectiveRevisionUpdate
    use onFineObjectiveRevisionChanged instead. removal after 2026-11-20.
  • Operation onLearningPhaseRevisionUpdate
    use onLearningPhaseRevisionChanged instead. removal after 2026-11-20.
  • Operation onNotificationsUpdate
    use onNotificationsChanged instead. removal after 2026-11-20.
  • Operation onObjectiveRevisionUpdate
    use onObjectiveRevisionChanged instead. removal after 2026-11-20.
  • Operation onOwnUserUpdate
    use onOwnUserChanged instead. removal after 2026-11-20.
  • Operation onTagUpdate
    use onTagChanged instead. removal after 2026-11-20.
  • Enum value PrivilegeScope.HINT
    Hints are part of exercises, so a separate privilege scope is no longer needed.
  • Operation refreshToken
    Request a new token with the OAuth2 client_credentials grant instead, see Authentication, removal after 2027-01-14.
  • Operation removeOwnUserSingleSignOnProvider
    Accounts are linked to a single sign-on provider during sign-in. removal after 2027-01-14.
  • Operation requestPasswordReset
    Passwords are reset on the sign-in page of the authentication server. removal after 2027-01-14.
  • Operation setNewPassword
    Passwords are reset on the sign-in page of the authentication server. removal after 2027-01-14.
  • Operation signinUser
    Users now sign in through the OpenID Connect flow of the authentication server. API integrations use an API key with the OAuth2 client_credentials grant instead, see Authentication, removal after 2027-01-14.
  • Operation signinUserWithAPIKey
    Use the API key with the OAuth2 client_credentials grant instead, see Authentication, removal after 2027-01-14.
  • Operation signinUserWithSingleSignOn
    Single sign-on happens on the sign-in page of the authentication server. removal after 2027-01-14.
  • Field SingleSignOnProvider.redirectUrl
    The authentication server builds the authorization URL itself. removal after 2027-01-14.
  • Input field SystemContentFilter.ordering
    The ordering option is no longer supported.
  • Operation updateOwnUserSingleSignOnProvider
    Accounts are linked to a single sign-on provider during sign-in. removal after 2027-01-14.

Removed

Section titled “Removed”
  • Operation exerciseImport · removed
    Not supported anymore. use createExercise and related functions instead
  • Operation checkExerciseImport · removed
    Not supported anymore. use createExercise and related functions instead
  • Type ExcelImportError · removed
    Type ‘ExcelImportError’ was removed
  • Enum value Privilege.EXERCISE_IMPORT · removed
    Enum value ‘EXERCISE_IMPORT’ was removed from enum ‘Privilege’
  • Enum value UploadType.IMPORTFILE · removed
    Enum value ‘IMPORTFILE’ was removed from enum ‘UploadType’