Add docs/2026_01_upgrade

docs/2026_01_upgrade

@@ -0,0 +1,31 @@
+---
+title: 2026/01 upgrade
+---
+# 2026/01 upgrade
+
+From the 5th of January to the 15th of January there will be a major upgrade of the data catalogue infrastructure (SciCat - https://discovery.psi.ch and https://dacat.psi.ch)
+
+During this period, data archiving and retrieval will not be possible.
+
+## Required changes
+
+After the upgrade, few changes will be required:
+
+### CLI changes
+
+1. If you are not using pmodules, please download the latest CLI version (>=v3.0.0) by following the instructions [here](https://github.com/paulscherrerinstitute/scicat-cli?tab=readme-ov-file#manual-deployment-and-upgrade).
+2. Modify your ingestion scripts, following the [v3 instructions](https://github.com/paulscherrerinstitute/scicat-cli?tab=readme-ov-file#v3-changes);
+3. or download the [backwards compatible scripts](https://github.com/paulscherrerinstitute/scicat-cli?tab=readme-ov-file#backwards-compatibility-with-v2) (linux only). Please note these scripts will later be discontinued (~ next 6 months).
+
+### API changes
+
+Some APIs have been updated. This affects you only if you interact directly with the SciCat APIs. 
+
+1. You can already find and compare the new API specifications from our [QA environment](https://dacat-qa.psi.ch/explorer).
+2. Authorization update: API authorization now requires passing your token in the Authorization header, prefixed with Bearer, i.e. Bearer <MY_TOKEN>.
+
+### Recieving updates notifications
+
+To receive notifications on updates, please subscribe to the [scicat mailing list](https://psilists.ethz.ch/sympa/info/scicat).
+
+If you have questions, don't hesitate to contact us at scicat-help@lists.psi.ch.