Planned Maintenance – Authentication service upgrade

Introduction

On July 22, 2026 between 00:00 and 02:00 CEST, a scheduled maintenance will be performed on the authentication service. The service interruption should not exceed 10 minutes within that window.

Expected impact

During the interruption, generating new authentication tokens will not be possible. The token endpoint will be temporarily unavailable:

https://auth.octopia-io.net/auth/realms/maas/protocol/openid-connect/token

What you should do

Token validity will be automatically extended to 24 hours before the maintenance window begins, so integrations holding a valid token at the time of the interruption will continue to function normally.

To stay resilient during the window, we recommend:

• Check expires_in in your authentication responses and proactively refresh tokens before they expire, rather than waiting for a 401 response
• Implement retry strategies on token generation calls, so your integration recovers automatically once the service is back

Rollback plan

In the event of an unexpected failure, the team will revert to the previous version. Any updates will be communicated via this changelog.