renders

Delete a stored render (native app).

Native app only (DVT-4925): 404 unless the render app-stage is configured (editionCapabilities.renderDelete). Behavior depends on the caller.

Self-delete (any caller with dashboard:read but without render:delete): hard-deletes the caller's OWN user, email or email_scheduled render (row and stored object, one transaction, audited). Another user's render, a thumbnail, or a render under a different dashboard all read as 404; a caller whose credential lacks dashboard:read gets 403.

Admin delete (render:delete, admin or owner): deletes any render in the organization, including renders under a soft-deleted dashboard and renders requested by departed users. Non-thumbnail renders are hard-deleted. A version thumbnail is only soft-deleted (deletedAt set, object kept, no longer served; reversible with restoreRender).

409 while the render is still queued or rendering.

delete/v1/dashboards/{id}/renders/{renderId}

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/dashboards/{id}/renders/{renderId}
  • Auth: one of:
    • API key in cookie dvt_session
    • HTTP bearer

Response

The render was deleted (or

Changes

No recorded changes to this operation across all 1 revision of this API.