string
| human readable description. For example, a vis title, action name |
| [id](./kibana-plugin-core-public.kibanaexecutioncontext.id.md) | string
| unique value to identify the source |
| [name](./kibana-plugin-core-public.kibanaexecutioncontext.name.md) | string
| public name of a user-facing feature |
-| [type](./kibana-plugin-core-public.kibanaexecutioncontext.type.md) | string
| Kibana application initated an operation. Can be narrowed to an enum later. |
+| [type](./kibana-plugin-core-public.kibanaexecutioncontext.type.md) | string
| Kibana application initated an operation. |
| [url](./kibana-plugin-core-public.kibanaexecutioncontext.url.md) | string
| in browser - url to navigate to a current page, on server - endpoint path, for task: task SO url |
diff --git a/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.type.md b/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.type.md
index ca339ddd9d646..48009ebaaeaa5 100644
--- a/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.type.md
+++ b/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.type.md
@@ -4,7 +4,7 @@
## KibanaExecutionContext.type property
-Kibana application initated an operation. Can be narrowed to an enum later.
+Kibana application initated an operation.
Signature:
diff --git a/docs/development/core/server/kibana-plugin-core-server.md b/docs/development/core/server/kibana-plugin-core-server.md
index a26f8bd7b1594..a3f925151af61 100644
--- a/docs/development/core/server/kibana-plugin-core-server.md
+++ b/docs/development/core/server/kibana-plugin-core-server.md
@@ -329,6 +329,7 @@ The plugin integrates with the core system via lifecycle events: `setup`
| [SavedObjectsImportHook](./kibana-plugin-core-server.savedobjectsimporthook.md) | A hook associated with a specific saved object type, that will be invoked during the import process. The hook will have access to the objects of the registered type.Currently, the only supported feature for import hooks is to return warnings to be displayed in the UI when the import succeeds. The only interactions the hook can have with the import process is via the hook's response. Mutating the objects inside the hook's code will have no effect. |
| [SavedObjectsImportWarning](./kibana-plugin-core-server.savedobjectsimportwarning.md) | Composite type of all the possible types of import warnings.See [SavedObjectsImportSimpleWarning](./kibana-plugin-core-server.savedobjectsimportsimplewarning.md) and [SavedObjectsImportActionRequiredWarning](./kibana-plugin-core-server.savedobjectsimportactionrequiredwarning.md) for more details. |
| [SavedObjectsNamespaceType](./kibana-plugin-core-server.savedobjectsnamespacetype.md) | The namespace type dictates how a saved object can be interacted in relation to namespaces. Each type is mutually exclusive: \* single (default): This type of saved object is namespace-isolated, e.g., it exists in only one namespace. \* multiple: This type of saved object is shareable, e.g., it can exist in one or more namespaces. \* multiple-isolated: This type of saved object is namespace-isolated, e.g., it exists in only one namespace, but object IDs must be unique across all namespaces. This is intended to be an intermediate step when objects with a "single" namespace type are being converted to a "multiple" namespace type. In other words, objects with a "multiple-isolated" namespace type will be \*share-capable\*, but will not actually be shareable until the namespace type is changed to "multiple". \* agnostic: This type of saved object is global. |
+| [SavedObjectTypeExcludeFromUpgradeFilterHook](./kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md) | If defined, allows a type to run a search query and return a query filter that may match any documents which may be excluded from the next migration upgrade process. Useful for cleaning up large numbers of old documents which are no longer needed and may slow the migration process.If this hook fails, the migration will proceed without these documents having been filtered out, so this should not be used as a guarantee that these documents have been deleted.Experimental and subject to change |
| [SavedObjectUnsanitizedDoc](./kibana-plugin-core-server.savedobjectunsanitizeddoc.md) | Describes Saved Object documents from Kibana < 7.0.0 which don't have a references
root property defined. This type should only be used in migrations. |
| [ScopeableRequest](./kibana-plugin-core-server.scopeablerequest.md) | A user credentials container. It accommodates the necessary auth credentials to impersonate the current user.See [KibanaRequest](./kibana-plugin-core-server.kibanarequest.md). |
| [ServiceStatusLevel](./kibana-plugin-core-server.servicestatuslevel.md) | A convenience type that represents the union of each value in [ServiceStatusLevels](./kibana-plugin-core-server.servicestatuslevels.md). |
diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md
new file mode 100644
index 0000000000000..f5446b37dc29c
--- /dev/null
+++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md
@@ -0,0 +1,13 @@
+
+
+[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsType](./kibana-plugin-core-server.savedobjectstype.md) > [excludeOnUpgrade](./kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md)
+
+## SavedObjectsType.excludeOnUpgrade property
+
+If defined, allows a type to exclude unneeded documents from the migration process and effectively be deleted. See [SavedObjectTypeExcludeFromUpgradeFilterHook](./kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md) for more details.
+
+Signature:
+
+```typescript
+excludeOnUpgrade?: SavedObjectTypeExcludeFromUpgradeFilterHook;
+```
diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md
index c3aba5261561f..bdb90be2bc8fc 100644
--- a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md
+++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md
@@ -52,6 +52,7 @@ Example after converting to a multi-namespace (shareable) type in 8.1:
```
Note: migration function(s) can be optionally specified for any of these versions and will not interfere with the conversion process. |
+| [excludeOnUpgrade](./kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md) | SavedObjectTypeExcludeFromUpgradeFilterHook
| If defined, allows a type to exclude unneeded documents from the migration process and effectively be deleted. See [SavedObjectTypeExcludeFromUpgradeFilterHook](./kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md) for more details. |
| [hidden](./kibana-plugin-core-server.savedobjectstype.hidden.md) | boolean
| Is the type hidden by default. If true, repositories will not have access to this type unless explicitly declared as an extraType
when creating the repository.See [createInternalRepository](./kibana-plugin-core-server.savedobjectsservicestart.createinternalrepository.md). |
| [indexPattern](./kibana-plugin-core-server.savedobjectstype.indexpattern.md) | string
| If defined, the type instances will be stored in the given index instead of the default one. |
| [management](./kibana-plugin-core-server.savedobjectstype.management.md) | SavedObjectsTypeManagementDefinition<Attributes>
| An optional [saved objects management section](./kibana-plugin-core-server.savedobjectstypemanagementdefinition.md) definition for the type. |
diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md b/docs/development/core/server/kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md
new file mode 100644
index 0000000000000..bd1c43529895c
--- /dev/null
+++ b/docs/development/core/server/kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md
@@ -0,0 +1,19 @@
+
+
+[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectTypeExcludeFromUpgradeFilterHook](./kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md)
+
+## SavedObjectTypeExcludeFromUpgradeFilterHook type
+
+If defined, allows a type to run a search query and return a query filter that may match any documents which may be excluded from the next migration upgrade process. Useful for cleaning up large numbers of old documents which are no longer needed and may slow the migration process.
+
+If this hook fails, the migration will proceed without these documents having been filtered out, so this should not be used as a guarantee that these documents have been deleted.
+
+Experimental and subject to change
+
+Signature:
+
+```typescript
+export declare type SavedObjectTypeExcludeFromUpgradeFilterHook = (toolkit: {
+ readonlyEsClient: PickWzBI
z-8s3E;TbE{FK#tBc_nG4ov7R^!eT<*ZuH`QkBNH2!D`IJgU OG qe#!FRbjbK!lwY>-t`Zdj1V=}>^YQ(bJ3GU@UTMUsHu<%lbI
zsG-$o6nb|MqJbV)Nf=~SVW;IOc6_5y>&@e-@%=J*?ZhRDvw0B-_rXybAFziqW2i^U
zYqC)dxb(STjXv;jhv4|!|q07F3K}en&ZR@C-N$I4q~^aW*vT<<_n>Fa8c$mdMP=+
zD|)?2HFzagXHyzAJGl?|`eBm-#l3WX74aJ8USftQY0NXrSQo4
z58mgg_#&YSQt^D+)S;r)N{TqX%#deC|M_W(%=l+ixBXW)>f&4SMwGcl-js8Pl5W^+
zQ$>#oT}Wc4+*GJJvuy>IUelpHI*`2|P?fbl-)v=ep+GyG>Wpo;b18ncQS_F_p_Xr`
zItD*LxA%4SKs)44q&p|Gu@5N=b~&*H?!rgoQgfqBe&qt+tbq&fvqN&f;1@koDPVaH
z=?)WtO+Yc@5!M+Dyg#9gZ5Pg>!abO7(6!CvWA|w(i`aae{_u%V!IQ+uGev>|(SJJC
z251MpD`xs|z;&8j(}Ah5{F;zP8~Rw8W1j#X(ig)f=8A5_Ed|4R)7Gv;R^L3iw2=u$
z5H>phJ=_48v(3<5gD}c%==tK1{FV|zRsWFzW?vgdCD$Z2o?Dtk=^_fqUou5i%Ji=2
zMCV#=&wrbxgxhbghiUU+W!udp6awug&vwP2*pKjqB>XUEVMD51{tX~{#^DGr63?L3
z`Ho`Yvi(dnvZw4)?9@&K9$^M~v8l`r?@V@%Jj0P#N8i(uMWS+GUuk
bCQVbjAgs*K#YC^lemAXFyqO
z>D@cDv~hn_b=_oKC~Y>+Aotma>p=STj^zOFy{z82!?z>%R9SrxqVtQ;#PRLqRgF)m
z2N_Xe+{GPC?+|(si6hKUC^Mv*PMoZAl+uG<29o-ZF#*3W!nUM0+KWcrchq=2uLfpJ
zdfnW@-%rprRNNf;x7I7x?~psOD?1GYBNvwOQtB9GFnOoO*7zSRugl4NaifxAOgL`E
z;ARSXFoJ;jGB|oGak%bZ8p6WL(F&b0U(+vj@I&z?`W#5s{)
$+GR<
zxZSzeOV?%B?H=4VvpU?!FFLHbT}JY*4|i91M=QOnou6{>Hp?H*yGzucWa&1ao-X}b
z
3JxL^
zTvRDI$m4O)sN^AM$wHfyg@r;O<)Vj}imqx+KT&jNB0p7&eDo&aer0e?8aajx4ez48
z5z$V^)U`6s?^&jZCfi7gXj=_wWbG0&OwaRfF){Qpk