diff --git a/doc/releases/migration-guide-4.0.rst b/doc/releases/migration-guide-4.0.rst
index 4e5ae29a09d..0d3cac7bcd4 100644
--- a/doc/releases/migration-guide-4.0.rst
+++ b/doc/releases/migration-guide-4.0.rst
@@ -107,6 +107,12 @@ Bluetooth Crypto
 Networking
 **********
 
+* The CoAP public API functions :c:func:`coap_get_block1_option` and
+  :c:func:`coap_get_block2_option` have changed. The ``block_number`` pointer
+  type has changed from ``uint8_t *`` to ``uint32_t *``. Additionally,
+  :c:func:`coap_get_block2_option` now accepts an additional ``bool *has_more``
+  parameter, to store the value of the more flag. (:github:`76052`)
+
 Other Subsystems
 ****************