From 73ff5566e17d42ba2b58c77d2411f2ace01e6bca Mon Sep 17 00:00:00 2001
From: pgayvallet <pierre.gayvallet@elastic.co>
Date: Fri, 28 Feb 2020 16:31:05 +0100
Subject: [PATCH] expose static method for so import / export

---
 ...plugin-server.getsortedobjectsforexport.md | 24 +++++++++++++++++++
 ...kibana-plugin-server.importsavedobjects.md | 24 +++++++++++++++++++
 .../core/server/kibana-plugin-server.md       |  8 +++++++
 ...ibana-plugin-server.resolveimporterrors.md | 24 +++++++++++++++++++
 ...plugin-server.savedobjectsimportoptions.md | 12 +++++-----
 ...ver.savedobjectsimportoptions.namespace.md |  2 ++
 ...r.savedobjectsimportoptions.objectlimit.md |  2 ++
 ...ver.savedobjectsimportoptions.overwrite.md |  2 ++
 ...er.savedobjectsimportoptions.readstream.md |  2 ++
 ...objectsimportoptions.savedobjectsclient.md |  2 ++
 ...avedobjectsimportoptions.supportedtypes.md |  2 ++
 ....savedobjectsresolveimporterrorsoptions.md | 12 +++++-----
 ...ctsresolveimporterrorsoptions.namespace.md |  2 ++
 ...sresolveimporterrorsoptions.objectlimit.md |  2 ++
 ...tsresolveimporterrorsoptions.readstream.md |  2 ++
 ...jectsresolveimporterrorsoptions.retries.md |  2 ++
 ...eimporterrorsoptions.savedobjectsclient.md |  2 ++
 ...solveimporterrorsoptions.supportedtypes.md |  2 ++
 ...servicesetup.getimportexportobjectlimit.md | 13 ++++++++++
 ...-plugin-server.savedobjectsservicesetup.md |  1 +
 src/core/server/index.ts                      |  3 +++
 .../export/get_sorted_objects_for_export.ts   |  6 +++++
 .../import/import_saved_objects.ts            |  6 +++++
 .../import/resolve_import_errors.ts           |  6 +++++
 src/core/server/saved_objects/import/types.ts | 12 ++++++++++
 src/core/server/saved_objects/types.ts        |  1 -
 src/core/server/server.api.md                 | 22 ++++++++---------
 27 files changed, 173 insertions(+), 25 deletions(-)
 create mode 100644 docs/development/core/server/kibana-plugin-server.getsortedobjectsforexport.md
 create mode 100644 docs/development/core/server/kibana-plugin-server.importsavedobjects.md
 create mode 100644 docs/development/core/server/kibana-plugin-server.resolveimporterrors.md
 create mode 100644 docs/development/core/server/kibana-plugin-server.savedobjectsservicesetup.getimportexportobjectlimit.md

diff --git a/docs/development/core/server/kibana-plugin-server.getsortedobjectsforexport.md b/docs/development/core/server/kibana-plugin-server.getsortedobjectsforexport.md
new file mode 100644
index 0000000000000..b43a28eff3cf4
--- /dev/null
+++ b/docs/development/core/server/kibana-plugin-server.getsortedobjectsforexport.md
@@ -0,0 +1,24 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-server](./kibana-plugin-server.md) &gt; [getSortedObjectsForExport](./kibana-plugin-server.getsortedobjectsforexport.md)
+
+## getSortedObjectsForExport() function
+
+Generates sorted saved object stream to be used for export. See the [options](./kibana-plugin-server.savedobjectsexportoptions.md) for more detailed information.
+
+<b>Signature:</b>
+
+```typescript
+export declare function getSortedObjectsForExport({ types, objects, search, savedObjectsClient, exportSizeLimit, includeReferencesDeep, excludeExportDetails, namespace, }: SavedObjectsExportOptions): Promise<import("stream").Readable>;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  { types, objects, search, savedObjectsClient, exportSizeLimit, includeReferencesDeep, excludeExportDetails, namespace, } | <code>SavedObjectsExportOptions</code> |  |
+
+<b>Returns:</b>
+
+`Promise<import("stream").Readable>`
+
diff --git a/docs/development/core/server/kibana-plugin-server.importsavedobjects.md b/docs/development/core/server/kibana-plugin-server.importsavedobjects.md
new file mode 100644
index 0000000000000..8208e2673c00a
--- /dev/null
+++ b/docs/development/core/server/kibana-plugin-server.importsavedobjects.md
@@ -0,0 +1,24 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-server](./kibana-plugin-server.md) &gt; [importSavedObjects](./kibana-plugin-server.importsavedobjects.md)
+
+## importSavedObjects() function
+
+Import saved objects from given stream. See the [options](./kibana-plugin-server.savedobjectsimportoptions.md) for more detailed information.
+
+<b>Signature:</b>
+
+```typescript
+export declare function importSavedObjects({ readStream, objectLimit, overwrite, savedObjectsClient, supportedTypes, namespace, }: SavedObjectsImportOptions): Promise<SavedObjectsImportResponse>;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  { readStream, objectLimit, overwrite, savedObjectsClient, supportedTypes, namespace, } | <code>SavedObjectsImportOptions</code> |  |
+
+<b>Returns:</b>
+
+`Promise<SavedObjectsImportResponse>`
+
diff --git a/docs/development/core/server/kibana-plugin-server.md b/docs/development/core/server/kibana-plugin-server.md
index 15a1fd0506256..63d85ea97416b 100644
--- a/docs/development/core/server/kibana-plugin-server.md
+++ b/docs/development/core/server/kibana-plugin-server.md
@@ -37,6 +37,14 @@ The plugin integrates with the core system via lifecycle events: `setup`<!-- -->
 |  [AuthResultType](./kibana-plugin-server.authresulttype.md) |  |
 |  [AuthStatus](./kibana-plugin-server.authstatus.md) | Status indicating an outcome of the authentication. |
 
+## Functions
+
+|  Function | Description |
+|  --- | --- |
+|  [getSortedObjectsForExport({ types, objects, search, savedObjectsClient, exportSizeLimit, includeReferencesDeep, excludeExportDetails, namespace, })](./kibana-plugin-server.getsortedobjectsforexport.md) | Generates sorted saved object stream to be used for export. See the [options](./kibana-plugin-server.savedobjectsexportoptions.md) for more detailed information. |
+|  [importSavedObjects({ readStream, objectLimit, overwrite, savedObjectsClient, supportedTypes, namespace, })](./kibana-plugin-server.importsavedobjects.md) | Import saved objects from given stream. See the [options](./kibana-plugin-server.savedobjectsimportoptions.md) for more detailed information. |
+|  [resolveImportErrors({ readStream, objectLimit, retries, savedObjectsClient, supportedTypes, namespace, })](./kibana-plugin-server.resolveimporterrors.md) | Resolve and return saved object import errors. See the [options](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.md) for more detailed informations. |
+
 ## Interfaces
 
 |  Interface | Description |
diff --git a/docs/development/core/server/kibana-plugin-server.resolveimporterrors.md b/docs/development/core/server/kibana-plugin-server.resolveimporterrors.md
new file mode 100644
index 0000000000000..9288c666f2acb
--- /dev/null
+++ b/docs/development/core/server/kibana-plugin-server.resolveimporterrors.md
@@ -0,0 +1,24 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-server](./kibana-plugin-server.md) &gt; [resolveImportErrors](./kibana-plugin-server.resolveimporterrors.md)
+
+## resolveImportErrors() function
+
+Resolve and return saved object import errors. See the [options](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.md) for more detailed informations.
+
+<b>Signature:</b>
+
+```typescript
+export declare function resolveImportErrors({ readStream, objectLimit, retries, savedObjectsClient, supportedTypes, namespace, }: SavedObjectsResolveImportErrorsOptions): Promise<SavedObjectsImportResponse>;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  { readStream, objectLimit, retries, savedObjectsClient, supportedTypes, namespace, } | <code>SavedObjectsResolveImportErrorsOptions</code> |  |
+
+<b>Returns:</b>
+
+`Promise<SavedObjectsImportResponse>`
+
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.md b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.md
index 9653fa802a3e8..7ee1e848c081f 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.md
@@ -16,10 +16,10 @@ export interface SavedObjectsImportOptions
 
 |  Property | Type | Description |
 |  --- | --- | --- |
-|  [namespace](./kibana-plugin-server.savedobjectsimportoptions.namespace.md) | <code>string</code> |  |
-|  [objectLimit](./kibana-plugin-server.savedobjectsimportoptions.objectlimit.md) | <code>number</code> |  |
-|  [overwrite](./kibana-plugin-server.savedobjectsimportoptions.overwrite.md) | <code>boolean</code> |  |
-|  [readStream](./kibana-plugin-server.savedobjectsimportoptions.readstream.md) | <code>Readable</code> |  |
-|  [savedObjectsClient](./kibana-plugin-server.savedobjectsimportoptions.savedobjectsclient.md) | <code>SavedObjectsClientContract</code> |  |
-|  [supportedTypes](./kibana-plugin-server.savedobjectsimportoptions.supportedtypes.md) | <code>string[]</code> |  |
+|  [namespace](./kibana-plugin-server.savedobjectsimportoptions.namespace.md) | <code>string</code> | if specified, will import in given namespace |
+|  [objectLimit](./kibana-plugin-server.savedobjectsimportoptions.objectlimit.md) | <code>number</code> | The maximum number of object to import |
+|  [overwrite](./kibana-plugin-server.savedobjectsimportoptions.overwrite.md) | <code>boolean</code> | if true, will override existing object if present |
+|  [readStream](./kibana-plugin-server.savedobjectsimportoptions.readstream.md) | <code>Readable</code> | The stream of [saved objects](./kibana-plugin-server.savedobject.md) to import |
+|  [savedObjectsClient](./kibana-plugin-server.savedobjectsimportoptions.savedobjectsclient.md) | <code>SavedObjectsClientContract</code> | client to use to perform the import operation |
+|  [supportedTypes](./kibana-plugin-server.savedobjectsimportoptions.supportedtypes.md) | <code>string[]</code> | the list of allowed types to import |
 
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.namespace.md b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.namespace.md
index 2b15ba2a1b7ec..c99d2682bdcea 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.namespace.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.namespace.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsImportOptions.namespace property
 
+if specified, will import in given namespace
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.objectlimit.md b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.objectlimit.md
index 89c01a13644b8..526aef96eb8c0 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.objectlimit.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.objectlimit.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsImportOptions.objectLimit property
 
+The maximum number of object to import
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.overwrite.md b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.overwrite.md
index 54728aaa80fed..3a84001bbbad4 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.overwrite.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.overwrite.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsImportOptions.overwrite property
 
+if true, will override existing object if present
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.readstream.md b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.readstream.md
index 7739fdfbc8460..64875d42515aa 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.readstream.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.readstream.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsImportOptions.readStream property
 
+The stream of [saved objects](./kibana-plugin-server.savedobject.md) to import
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.savedobjectsclient.md b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.savedobjectsclient.md
index 23d5aba5fe114..8de2bc516af74 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.savedobjectsclient.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.savedobjectsclient.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsImportOptions.savedObjectsClient property
 
+client to use to perform the import operation
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.supportedtypes.md b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.supportedtypes.md
index 03ee12ab2a0f7..a897551bfcb12 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.supportedtypes.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsimportoptions.supportedtypes.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsImportOptions.supportedTypes property
 
+the list of allowed types to import
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.md b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.md
index 8ed978d4a2639..75c9d77c5bf67 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.md
@@ -16,10 +16,10 @@ export interface SavedObjectsResolveImportErrorsOptions
 
 |  Property | Type | Description |
 |  --- | --- | --- |
-|  [namespace](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.namespace.md) | <code>string</code> |  |
-|  [objectLimit](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.objectlimit.md) | <code>number</code> |  |
-|  [readStream](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.readstream.md) | <code>Readable</code> |  |
-|  [retries](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.retries.md) | <code>SavedObjectsImportRetry[]</code> |  |
-|  [savedObjectsClient](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.savedobjectsclient.md) | <code>SavedObjectsClientContract</code> |  |
-|  [supportedTypes](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.supportedtypes.md) | <code>string[]</code> |  |
+|  [namespace](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.namespace.md) | <code>string</code> | if specified, will import in given namespace |
+|  [objectLimit](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.objectlimit.md) | <code>number</code> | The maximum number of object to import |
+|  [readStream](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.readstream.md) | <code>Readable</code> | The stream of [saved objects](./kibana-plugin-server.savedobject.md) to resolve errors from |
+|  [retries](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.retries.md) | <code>SavedObjectsImportRetry[]</code> | saved object import references to retry |
+|  [savedObjectsClient](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.savedobjectsclient.md) | <code>SavedObjectsClientContract</code> | client to use to perform the import operation |
+|  [supportedTypes](./kibana-plugin-server.savedobjectsresolveimporterrorsoptions.supportedtypes.md) | <code>string[]</code> | the list of allowed types to import |
 
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.namespace.md b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.namespace.md
index b88f124545bd5..87b69c78b33ee 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.namespace.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.namespace.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsResolveImportErrorsOptions.namespace property
 
+if specified, will import in given namespace
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.objectlimit.md b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.objectlimit.md
index a2753ceccc36f..57a3c358406d8 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.objectlimit.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.objectlimit.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsResolveImportErrorsOptions.objectLimit property
 
+The maximum number of object to import
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.readstream.md b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.readstream.md
index e7a31deed6faa..f109816c0de54 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.readstream.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.readstream.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsResolveImportErrorsOptions.readStream property
 
+The stream of [saved objects](./kibana-plugin-server.savedobject.md) to resolve errors from
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.retries.md b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.retries.md
index 658aa64cfc33f..265dd21b3728a 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.retries.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.retries.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsResolveImportErrorsOptions.retries property
 
+saved object import references to retry
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.savedobjectsclient.md b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.savedobjectsclient.md
index 8a8c620b2cf21..9a1864bfbbcd6 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.savedobjectsclient.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.savedobjectsclient.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsResolveImportErrorsOptions.savedObjectsClient property
 
+client to use to perform the import operation
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.supportedtypes.md b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.supportedtypes.md
index 9cc97c34669b7..e5db98aec23d9 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.supportedtypes.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsresolveimporterrorsoptions.supportedtypes.md
@@ -4,6 +4,8 @@
 
 ## SavedObjectsResolveImportErrorsOptions.supportedTypes property
 
+the list of allowed types to import
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsservicesetup.getimportexportobjectlimit.md b/docs/development/core/server/kibana-plugin-server.savedobjectsservicesetup.getimportexportobjectlimit.md
new file mode 100644
index 0000000000000..d8ec90d1718dc
--- /dev/null
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsservicesetup.getimportexportobjectlimit.md
@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-server](./kibana-plugin-server.md) &gt; [SavedObjectsServiceSetup](./kibana-plugin-server.savedobjectsservicesetup.md) &gt; [getImportExportObjectLimit](./kibana-plugin-server.savedobjectsservicesetup.getimportexportobjectlimit.md)
+
+## SavedObjectsServiceSetup.getImportExportObjectLimit property
+
+Returns the maximum number of objects allowed for import or export operations.
+
+<b>Signature:</b>
+
+```typescript
+getImportExportObjectLimit: () => number;
+```
diff --git a/docs/development/core/server/kibana-plugin-server.savedobjectsservicesetup.md b/docs/development/core/server/kibana-plugin-server.savedobjectsservicesetup.md
index b6f2e7320c48a..77a8c0c981cab 100644
--- a/docs/development/core/server/kibana-plugin-server.savedobjectsservicesetup.md
+++ b/docs/development/core/server/kibana-plugin-server.savedobjectsservicesetup.md
@@ -52,6 +52,7 @@ export class Plugin() {
 |  Property | Type | Description |
 |  --- | --- | --- |
 |  [addClientWrapper](./kibana-plugin-server.savedobjectsservicesetup.addclientwrapper.md) | <code>(priority: number, id: string, factory: SavedObjectsClientWrapperFactory) =&gt; void</code> | Add a [client wrapper factory](./kibana-plugin-server.savedobjectsclientwrapperfactory.md) with the given priority. |
+|  [getImportExportObjectLimit](./kibana-plugin-server.savedobjectsservicesetup.getimportexportobjectlimit.md) | <code>() =&gt; number</code> | Returns the maximum number of objects allowed for import or export operations. |
 |  [registerType](./kibana-plugin-server.savedobjectsservicesetup.registertype.md) | <code>(type: SavedObjectsType) =&gt; void</code> | Register a [savedObjects type](./kibana-plugin-server.savedobjectstype.md) definition.<!-- -->See the [mappings format](./kibana-plugin-server.savedobjectstypemappingdefinition.md) and [migration format](./kibana-plugin-server.savedobjectmigrationmap.md) for more details about these. |
 |  [setClientFactoryProvider](./kibana-plugin-server.savedobjectsservicesetup.setclientfactoryprovider.md) | <code>(clientFactoryProvider: SavedObjectsClientFactoryProvider) =&gt; void</code> | Set the default [factory provider](./kibana-plugin-server.savedobjectsclientfactoryprovider.md) for creating Saved Objects clients. Only one provider can be set, subsequent calls to this method will fail. |
 
diff --git a/src/core/server/index.ts b/src/core/server/index.ts
index e45d4f28edcc3..51d9db2936822 100644
--- a/src/core/server/index.ts
+++ b/src/core/server/index.ts
@@ -229,6 +229,9 @@ export {
   SavedObjectsType,
   SavedObjectMigrationMap,
   SavedObjectMigrationFn,
+  getSortedObjectsForExport,
+  importSavedObjects,
+  resolveImportErrors,
 } from './saved_objects';
 
 export {
diff --git a/src/core/server/saved_objects/export/get_sorted_objects_for_export.ts b/src/core/server/saved_objects/export/get_sorted_objects_for_export.ts
index 4b4cf1146aca0..7f373e49ee45a 100644
--- a/src/core/server/saved_objects/export/get_sorted_objects_for_export.ts
+++ b/src/core/server/saved_objects/export/get_sorted_objects_for_export.ts
@@ -124,6 +124,12 @@ async function fetchObjectsToExport({
   }
 }
 
+/**
+ * Generates sorted saved object stream to be used for export.
+ * See the {@link SavedObjectsExportOptions | options} for more detailed information.
+ *
+ * @public
+ */
 export async function getSortedObjectsForExport({
   types,
   objects,
diff --git a/src/core/server/saved_objects/import/import_saved_objects.ts b/src/core/server/saved_objects/import/import_saved_objects.ts
index ef3b4a214c2c2..911493ee88fb7 100644
--- a/src/core/server/saved_objects/import/import_saved_objects.ts
+++ b/src/core/server/saved_objects/import/import_saved_objects.ts
@@ -26,6 +26,12 @@ import {
 } from './types';
 import { validateReferences } from './validate_references';
 
+/**
+ * Import saved objects from given stream. See the {@link SavedObjectsImportOptions | options} for more
+ * detailed information.
+ *
+ * @public
+ */
 export async function importSavedObjects({
   readStream,
   objectLimit,
diff --git a/src/core/server/saved_objects/import/resolve_import_errors.ts b/src/core/server/saved_objects/import/resolve_import_errors.ts
index 6f56f283b4aec..be349d7da77e7 100644
--- a/src/core/server/saved_objects/import/resolve_import_errors.ts
+++ b/src/core/server/saved_objects/import/resolve_import_errors.ts
@@ -27,6 +27,12 @@ import {
 } from './types';
 import { validateReferences } from './validate_references';
 
+/**
+ * Resolve and return saved object import errors.
+ * See the {@link SavedObjectsResolveImportErrorsOptions | options} for more detailed informations.
+ *
+ * @public
+ */
 export async function resolveImportErrors({
   readStream,
   objectLimit,
diff --git a/src/core/server/saved_objects/import/types.ts b/src/core/server/saved_objects/import/types.ts
index 44046378a7b97..9d86af32d681a 100644
--- a/src/core/server/saved_objects/import/types.ts
+++ b/src/core/server/saved_objects/import/types.ts
@@ -107,11 +107,17 @@ export interface SavedObjectsImportResponse {
  * @public
  */
 export interface SavedObjectsImportOptions {
+  /** The stream of {@link SavedObject | saved objects} to import */
   readStream: Readable;
+  /** The maximum number of object to import */
   objectLimit: number;
+  /** if true, will override existing object if present */
   overwrite: boolean;
+  /** client to use to perform the import operation */
   savedObjectsClient: SavedObjectsClientContract;
+  /** the list of allowed types to import */
   supportedTypes: string[];
+  /** if specified, will import in given namespace */
   namespace?: string;
 }
 
@@ -120,10 +126,16 @@ export interface SavedObjectsImportOptions {
  * @public
  */
 export interface SavedObjectsResolveImportErrorsOptions {
+  /** The stream of {@link SavedObject | saved objects} to resolve errors from */
   readStream: Readable;
+  /** The maximum number of object to import */
   objectLimit: number;
+  /** client to use to perform the import operation */
   savedObjectsClient: SavedObjectsClientContract;
+  /** saved object import references to retry */
   retries: SavedObjectsImportRetry[];
+  /** the list of allowed types to import */
   supportedTypes: string[];
+  /** if specified, will import in given namespace */
   namespace?: string;
 }
diff --git a/src/core/server/saved_objects/types.ts b/src/core/server/saved_objects/types.ts
index 495d896ad12cd..c9c672d0f8b1c 100644
--- a/src/core/server/saved_objects/types.ts
+++ b/src/core/server/saved_objects/types.ts
@@ -62,7 +62,6 @@ export interface SavedObjectsMigrationVersion {
 }
 
 /**
- *
  * @public
  */
 export interface SavedObject<T = unknown> {
diff --git a/src/core/server/server.api.md b/src/core/server/server.api.md
index 8f4feb7169651..18b836f5887a1 100644
--- a/src/core/server/server.api.md
+++ b/src/core/server/server.api.md
@@ -777,6 +777,9 @@ export type GetAuthState = <T = unknown>(request: KibanaRequest | LegacyRequest)
     state: T;
 };
 
+// @public
+export function getSortedObjectsForExport({ types, objects, search, savedObjectsClient, exportSizeLimit, includeReferencesDeep, excludeExportDetails, namespace, }: SavedObjectsExportOptions): Promise<import("stream").Readable>;
+
 // @public
 export type HandlerContextType<T extends HandlerFunction<any>> = T extends HandlerFunction<infer U> ? U : never;
 
@@ -891,6 +894,9 @@ export interface ImageValidation {
     };
 }
 
+// @public
+export function importSavedObjects({ readStream, objectLimit, overwrite, savedObjectsClient, supportedTypes, namespace, }: SavedObjectsImportOptions): Promise<SavedObjectsImportResponse>;
+
 // @public (undocumented)
 export interface IndexSettingsDeprecationInfo {
     // (undocumented)
@@ -1369,6 +1375,9 @@ export type RequestHandlerContextContainer = IContextContainer<RequestHandler<an
 // @public
 export type RequestHandlerContextProvider<TContextName extends keyof RequestHandlerContext> = IContextProvider<RequestHandler<any, any, any>, TContextName>;
 
+// @public
+export function resolveImportErrors({ readStream, objectLimit, retries, savedObjectsClient, supportedTypes, namespace, }: SavedObjectsResolveImportErrorsOptions): Promise<SavedObjectsImportResponse>;
+
 // @public
 export type ResponseError = string | Error | {
     message: string | Error;
@@ -1827,17 +1836,11 @@ export interface SavedObjectsImportMissingReferencesError {
 
 // @public
 export interface SavedObjectsImportOptions {
-    // (undocumented)
     namespace?: string;
-    // (undocumented)
     objectLimit: number;
-    // (undocumented)
     overwrite: boolean;
-    // (undocumented)
     readStream: Readable;
-    // (undocumented)
     savedObjectsClient: SavedObjectsClientContract;
-    // (undocumented)
     supportedTypes: string[];
 }
 
@@ -1991,17 +1994,11 @@ export interface SavedObjectsRepositoryFactory {
 
 // @public
 export interface SavedObjectsResolveImportErrorsOptions {
-    // (undocumented)
     namespace?: string;
-    // (undocumented)
     objectLimit: number;
-    // (undocumented)
     readStream: Readable;
-    // (undocumented)
     retries: SavedObjectsImportRetry[];
-    // (undocumented)
     savedObjectsClient: SavedObjectsClientContract;
-    // (undocumented)
     supportedTypes: string[];
 }
 
@@ -2032,6 +2029,7 @@ export class SavedObjectsSerializer {
 // @public
 export interface SavedObjectsServiceSetup {
     addClientWrapper: (priority: number, id: string, factory: SavedObjectsClientWrapperFactory) => void;
+    getImportExportObjectLimit: () => number;
     registerType: (type: SavedObjectsType) => void;
     setClientFactoryProvider: (clientFactoryProvider: SavedObjectsClientFactoryProvider) => void;
 }