[Docs] Add details to SO APIs landing page

docs/api/dashboard-api.asciidoc

@@ -1,7 +1,7 @@
 [[dashboard-api]]
 == Import and export dashboard APIs
 
-deprecated::[7.15.0,Both of these APIs have been deprecated in favor of the {api-kibana}/group/endpoint-saved-objects[saved objects API].]
+deprecated::[7.15.0,Both of these APIs have been deprecated and will be removed in 9.0.0]
 
 Import and export dashboards with the corresponding saved objects, such as visualizations, saved
 searches, and data views.
@@ -16,4 +16,4 @@ The following import and export dashboard APIs are available:
 * <<dashboard-api-export, Export dashboard API>> to export dashboards and corresponding saved objects
 
 include::dashboard/import-dashboard.asciidoc[]
-include::dashboard/export-dashboard.asciidoc[]
+include::dashboard/export-dashboard.asciidoc[]

docs/api/data-views.asciidoc

@@ -8,5 +8,3 @@ For the latest details, refer to {api-kibana}/group/endpoint-data-views[data vie
 WARNING: Do not write documents directly to the `.kibana` index. When you write directly
 to the `.kibana` index, the data becomes corrupted and permanently breaks future {kib} versions.
 
-WARNING: Use the data views APIs for managing data views instead of lower-level <<saved-objects-api, saved objects API>>.
-

docs/api/osquery-manager.asciidoc

@@ -3,7 +3,7 @@
 
 experimental[] Run live queries, manage packs and saved queries
 
-WARNING: Use the osquery manager APIs for managing packs and saved queries instead of lower-level <<saved-objects-api, saved objects API>>.
+Use the osquery manager APIs for managing packs and saved queries.
 
 The following osquery manager APIs are available: 
 

docs/api/saved-objects.asciidoc

@@ -1,9 +1,18 @@
 [[saved-objects-api]]
 == Saved objects APIs
 
-Manage {kib} saved objects, including dashboards, visualizations, and more.
+Export sets of saved objects that you want to import into {kib}, resolve import errors and rotate an encryption key for encrypted saved objects with the saved objects APIs.
+
+Manage a specific type of saved object with the corresponding APIs, for example, use:
+
+* <<data-views-api>> for managing data views
+* <<spaces-api>> for managing spaces
+* <<short-urls-api>> for managing short urls
+
+and others.
 
 For the latest details, refer to the {api-kibana}/group/endpoint-saved-objects[saved object API].
 
 WARNING: Do not write documents directly to the `.kibana` index. When you write directly
 to the `.kibana` index, the data becomes corrupted and permanently breaks future {kib} versions.
+

docs/api/short-urls.asciidoc

@@ -1,7 +1,14 @@
 [[short-urls-api]]
 == Short URLs APIs
 
-Manage {kib} short URLs.
+experimental[] Manage {kib} short URLs.
+
+The following short urls APIs are available:
+
+* <<short-urls-api-create, Create short URL API>>
+* <<short-urls-api-get, Get short URL API>>
+* <<short-urls-api-delete, Delete short URL API>>
+* <<short-urls-api-resolve, Resolve short URL API>>
 
 include::short-urls/create-short-url.asciidoc[]
 include::short-urls/get-short-url.asciidoc[]