Delete saved view

Permanently removes a saved view from the system, deleting its complete configuration including all grid state, filters, sort preferences, and timeline settings. This is an asynchronous operation that returns immediately with an AsyncOperationResponse containing operation tracking IDs, while the actual deletion completes in the background. Once deleted, the saved view cannot be recovered and will no longer appear in user view selectors or API list responses. Use this endpoint when users explicitly choose to remove saved views they no longer need, when cleaning up obsolete or duplicate views during workspace reorganization, or when implementing view management features that allow users to curate their saved view collections. Only the view owner or users with manage permissions for the containing space can delete saved views. For example, call this endpoint when a user clicks the delete button on 'Old Q3 Tasks' view in their view management interface, or when programmatically removing test views created during development. The operation is idempotent - attempting to delete an already-deleted view returns 404 Not Found.

Key Features:

  • Asynchronous deletion with immediate response containing tracking operation IDs

  • Permanent removal with no recovery option - ensure user confirmation before calling

  • Idempotent operation - safe to retry if initial request times out

  • Automatically removes view from all user interfaces and list endpoints upon completion

    Authorization Logic:

  • Requires manage permissions for the space (seismic.programs.manage)

  • Only view owners or space administrators can delete saved views

  • Attempting to delete another user's private view returns 403 Forbidden

  • System-provided default views cannot be deleted

Usage Example:

When implementing a view management panel, display a delete button for each user-created view. Upon user confirmation, call DELETE /v2/spaces/abc123/savedViews/sv789 which returns AsyncOperationResponse with asyncOperationIds for tracking. Poll the async operation status if needed, or simply remove the view from your local UI state immediately since the operation will complete shortly.

Path Params
string
required
length between 7 and 22

The unique identifier of the space containing the target entity. This determines the scope of entity queries and ensures proper access control. The space must be accessible to the authenticated user with appropriate permissions. It can be the unique identifier (GUID) of the space or the word "default" to indicate the default programs space. Common values include "default" and "rkr83lapKkyCJuLLWqLqzB".

string
required

Unique identifier for the specific saved view to permanently delete. This is a stable string ID in base64url or GUID format (example sv7YtMp2kQxRvN9LmW4HzAg). Use this ID to target the exact saved view you want to remove from the system. The view must exist in the specified space and you must have deletion permissions (owner or space admin). Required for all delete operations on saved views. Deletion is permanent and cannot be undone.

Responses

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json