Saved Objects API as production feature

[inf17101]

Are you planning to introduce the Saved Objects API as a fixed productive feature or is the Saved Objects API exactly like Elastic since a few versions experimental?

If it is experimental, will it be available always and continuously and eventually be passed over as a productive feature?

We want to import and export changed versions of visualizations and dashboards and for the purpose of automation we want to use the Saved Objects API permanently to import changed dashboards for different customers.

It would be nice to have a reliable Saved Objects API that is also maintained and is recommended to use productively, hence the feature request.

[tmarkley]

We don't currently have Dashboards APIs documented in the opensearch.org docs site, so that's certainly a gap. We're also working on determining how to handle "experimental" features/APIs for OpenSearch Dashboards moving forward. We don't currently have any plans on the roadmap to change the Saved Objects API.

[tmarkley]

@ahopp it'd be great to get your thoughts here too.

[tmarkley]

Related to #800

[ahopp]

@inf17101 we don't have any expectation of dropping Saved Objects API. While we can't say "always and continuously" with any feature, we currently expect it to be maintained.

@tmarkley I think we should drop the "experimental" as it's part of the product in my opinion and we should maintain. But we should also make sure we continue to elevate the code as there are some opportunities to improve (e.g. error codes).

[sastorsl]

A couple of basic examples in the docs would be nice.
For instance something similar to the OpenSearch Popular API's.

# Export all saved objects for backup purposes
curl \
    -snk \
    --netrc-file ~/.netrc \
    -H "Content-Type: application/json" \
    -H "osd-xsrf:true" \
    -o /tmp/opensearch-dashboards-export.json \
    -XPOST \
    https://my.opensearch-dashboards.url/api/saved_objects/_export \
    -d '{"type":["index-pattern","config","search","dashboard","url","query","visualization"],"includeReferencesDeep":true}'