---
title: "requestSceneSessionDestruction(_:options:errorHandler:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uiapplication/requestscenesessiondestruction(_:options:errorhandler:)"
---

# requestSceneSessionDestruction(_:options:errorHandler:)

Asks the system to dismiss an existing scene and remove it from the app switcher.

## Declaration

```swift
func requestSceneSessionDestruction(_ sceneSession: UISceneSession, options: UISceneDestructionRequestOptions?, errorHandler: ((any Error) -> Void)? = nil)
```

## Parameters

- `sceneSession`: The session whose scene you want to remove from the screen and app switcher.
- `options`: Information for the system to use when dismissing the scene. For information about how to create this object, see doc://com.apple.uikit/documentation/UIKit/UISceneDestructionRequestOptions.
- `errorHandler`: An error handler block to execute if a problem occurs. The method does not execute this block when it successfully dismisses the scene. This block has no return value and has the following parameter:

## Discussion

Discussion If the specified scene is onscreen, calling this method dismisses it using the specified options. The method sends a disconnect notification to the scene and then calls your app delegate’s application(_:didDiscardSceneSessions:) method.

## See Also

### Managing a scene’s life cycle

- [activateSceneSession(for:errorHandler:)](uikit/uiapplication/activatescenesession(for:errorhandler:).md)
- [requestSceneSessionRefresh(_:)](uikit/uiapplication/requestscenesessionrefresh(_:).md)
- [UISceneSessionActivationRequest](uikit/uiscenesessionactivationrequest-swift.struct.md)
- [UIScene.ActivationRequestOptions](uikit/uiscene/activationrequestoptions.md)
- [UISceneDestructionRequestOptions](uikit/uiscenedestructionrequestoptions.md)