v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
data views

Swap saved object references

Spaces method and path for this operation:

<div><span class="operation-verb post">post</span>&nbsp;<span class="operation-path">/s/{space_id}/api/data_views/swap_references</span></div>

Refer to Spaces for more information.

Swap saved object references from one data view to another. Use this endpoint to update dashboards, visualizations, and other saved objects that reference a data view. WARNING: Misuse can break large numbers of saved objects! Use the _preview endpoint to see which saved objects would be affected before making changes.

post/api/data_views/swap_references

Headers

kbn-xsrfstring required

Cross-site request forgery protection

Request body

deleteboolean

Deletes referenced saved object if all references are removed.

forTypestring

Limit the affected saved objects by type.

fromIdstring required

The saved object reference to change.

fromTypestring

Specify the type of the saved object reference to alter. The default value is index-pattern for data views.

toIdstring required

New saved object reference value to replace the old value.

Response

Indicates a successful call.