diff --git a/src/core/MIGRATION_EXAMPLES.md b/src/core/MIGRATION_EXAMPLES.md
index d630fec652a375..3f34742e44861c 100644
--- a/src/core/MIGRATION_EXAMPLES.md
+++ b/src/core/MIGRATION_EXAMPLES.md
@@ -1082,7 +1082,7 @@ const { body } = await client.asInternalUser.get<GetResponse>({ id: 'id' });
 const { body } = await client.asInternalUser.get({ id: 'id' });
 ```
 
-- the returned error types changed 
+- the returned error types changed
 
 There are no longer specific errors for every HTTP status code (such as `BadRequest` or `NotFound`). A generic
 `ResponseError` with the specific `statusCode` is thrown instead.
@@ -1097,6 +1097,7 @@ try {
   if(e instanceof errors.NotFound) {
     // do something
   }
+  if(e.status === 401) {}
 }
 ``` 
 
@@ -1115,6 +1116,7 @@ try {
   if(e.name === 'ResponseError' && e.statusCode === 404) {
     // do something
   }
+  if(e.statusCode === 401) {...}
 }
 ```
 
@@ -1178,6 +1180,30 @@ const request = client.asCurrentUser.ping({}, {
 });
 ```
 
+- the new client doesn't provide exhaustive typings for the response object yet. You might have to copy
+response type definitions from the Legacy Elasticsearch library until https://github.com/elastic/elasticsearch-js/pull/970 merged.
+
+```ts
+// platform provides a few typings for internal purposes
+import { SearchResponse } from 'src/core/server';
+type SearchSource = {...};
+type SearchBody = SearchResponse<SearchSource>;
+const { body } = await client.search<SearchBody>(...);
+interface Info {...}
+const { body } = await client.info<Info>(...);
+```
+
+- Functional tests are subject to migration to the new client as well.
+before:
+```ts
+const client = getService('legacyEs');
+```
+
+after:
+```ts
+const client = getService('es');
+```
+
 Please refer to the  [Breaking changes list](https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current/breaking-changes.html)
 for more information about the changes between the legacy and new client.