Delete surface views
DELETE /api/v1/surface-views/{savedSurfaceViewId}: request fields and declared response contract.
DELETE/api/v1/surface-views/{savedSurfaceViewId}
| Property | Value |
|---|---|
| Permission | settings.read |
| Workspace scope | required |
| Scope target | workspace |
Parameters
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| savedSurfaceViewId | string | required | non-null | — |
Query parameters: none.
Response
200
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| data | object | required | non-null | — |
| data.savedSurfaceViewId | string | required | non-null | — |
| data.deleted | boolean | required | non-null | — |
Declared failures
| Property | Value |
|---|---|
| SAVED_SURFACE_VIEW_INVALID | 400 — not retryable |
| SAVED_SURFACE_VIEW_NOT_FOUND | 404 — not retryable |
| SAVED_SURFACE_VIEW_STORE_FAILED | 503 — retryable |
Readback
Read the result back with:
- savedSurfaceViews.listScoped
Request example
Schematic only. Replace placeholders with real values and include all required nested fields.
DELETE /api/v1/surface-views/{savedSurfaceViewId} HTTP/1.1
Authorization: Bearer <token>
x-merulan-workspace-id: <workspace-id>