diff --git a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_27.rst b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_27.rst
index e3b1515a548..fafca709024 100644
--- a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_27.rst
+++ b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_27.rst
@@ -16,16 +16,22 @@ Make sure your ``appinfo/info.xml`` allows for Nextcloud 27.
.. code-block:: xml
-
+
Front-end changes
-----------------
-Removed APIs
-^^^^^^^^^^^^
+Added APIs
+^^^^^^^^^^
+
+* A new Files Router API allows you to control the files router service and update views, querys or param without page reload (`nextcloud/server#37824 `_)
-* tbd
+ .. code-block:: js
+
+ // https://github.com/nextcloud/server/blob/master/apps/files/src/services/RouterService.ts
+ OCP.Files.Router.goTo('/trashbin?dir=/Unsplash.d1680193199')
+ OCP.Files.Router.goToRoute('fileslist', { view: 'files' }, { dir: '/Folders/Group folder' })
Back-end changes
----------------
@@ -38,19 +44,36 @@ Nextcloud 27 no longer loads classes in the deprecated :ref:`PSR-0 naming standa
Added APIs
^^^^^^^^^^
-* tbd
-
-Changed APIs
-^^^^^^^^^^^^
+* ``\OCP\AppFramework\Utility\ITimeFactory`` is now a ``\PSR\Clock\ClockInterface`` following the `PSR-20 standard `_. (`nextcloud/server#35872 `_)
+* ``\OCP\Accounts\IAccountManager::PROPERTY_DISPLAYNAME_LEGACY`` was added to keep the provisioning API compatible. (`nextcloud/server#36665 `_)
+* A new system config ``ratelimit.protection.enabled`` (boolean, default true) was added to allow developers to **disable** rate limiting. It is **not** recommended to disable this on a production/live system. (`nextcloud/server#37542 `_)
+* A new OCP API under ``\OCP\SpeechToText`` was introduced to allow automatic transcription of media (`nextcloud/server#37674 `_)
+* Added a new interface ``\OCP\BackgroundJob\IParallelAwareJob`` that ``\OCP\BackgroundJob\Job`` now implements. It can be used to allow specifying that multiple instances of a job should not be run at the same time. Also added ``\OCP\BackgroundJob\IJobList#hasReservedJob(?string $className = null)`` method to check the condition (`nextcloud/server#37835 `_)
+* New property ``$actionLabel`` has been added to the ``\OCP\Files\Template\TemplateFileCreator`` class with a respective setter ``TemplateFileCreator::setActionLabel`` and getter ``TemplateFileCreator::getActionLabel``. (`nextcloud/server#37929 `_ + `nextcloud/server#37955 `_)
+* A new interface ``\OCP\Group\Backend\ISearchableGroupBackend`` was added for group backends supporting new method ``searchInGroup`` to search among a group users in an efficient way. (`nextcloud/server#32866 `_)
-* tbd
Deprecated APIs
^^^^^^^^^^^^^^^
-* tbd
+* ``\OCP\AppFramework\Utility\ITimeFactory::getTime()`` and ``\OCP\AppFramework\Utility\ITimeFactory::getDateTime()`` were deprecated, because the interface is now a ``\PSR\Clock\ClockInterface`` following the `PSR-20standard `_. (`nextcloud/server#35872 `_)
+* ``\OCP\GroupInterface::usersInGroup()`` is deprecated in favor of newly added ``\OCP\Group\Backend\ISearchableGroupBackend`` interface. (`nextcloud/server#32866 `_)
Removed APIs
^^^^^^^^^^^^
-* tbd
+* Intermediate transition event classes ``\OCP\WorkflowEngine\IEntityCompat`` and ``\OCP\WorkflowEngine\IOperationCompat`` have been removed as advertised for 2023 (`nextcloud/server#37040 `_)
+
+
+Behavioral changes
+^^^^^^^^^^^^^^^^^^
+
+* ``\OCP\Files\Cache\CacheEntryRemovedEvent`` will now be dispatched for all files and folders inside the deleted node. (`nextcloud/server#34773 `_)
+
+Client APIs
+-----------
+
+Changed APIs
+^^^^^^^^^^^^
+
+* The OCS translation API was extended to return the ``from`` language attribute so in case no from was given, clients can afterwards show in the UI which language was detected and used for translating. (`nextcloud/server#38003 `_)