Context
Change Type: Announcement
Product area: Platform services
Component: REST API
Deployed at: eu.latest.cumulocity.com, apj.cumulocity.com, jp.cumulocity.com, cumulocity.com, us.cumulocity.com, emea.cumulocity.com
Technical details
Build artifact: cumulocity (2025.341.0)
Internal ID: MTM-64123
Description
Until now, tenant options were attached to each microservice request. The microservice proxy added the tenant options to the request headers and forwarded the request to the respective microservice.
For example, when creating a tenant option in a category that matches the application context path, the value has been passed to the microservice by the microservice proxy on the platform as a header (key => value).
This functionality is now deprecated. Tenant options will no longer be attached as headers to requests to microservices. The removal is planned for Q1 2026 in CD versions and in the 2027 annual release. The retrieval of the tenant options will remain possible through the endpoint <TENANT_DOMAIN>/application/currentApplication/settings.
This change is still disabled by default and can be enabled via a feature toggle core.ms-proxy.no-tenant-options-in-headers.
Important
In Q1 2026 for the CD versions and in 2027 for the yearly releases, this change will become mandatory.