<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "tvOS: 13.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIApplication/requestSceneSessionDestruction(_:options:errorHandler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UIApplication(im)requestSceneSessionDestruction:options:errorHandler:"
  },
  "title" : "requestSceneSessionDestruction(_:options:errorHandler:)"
}
-->

# requestSceneSessionDestruction(_:options:errorHandler:)

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

```
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 [`UISceneDestructionRequestOptions`](/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:

- error: The <doc://com.apple.documentation/documentation/Foundation/NSError> object describing the problem that occurred.

## 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:)`](/documentation/UIKit/UIApplicationDelegate/application(_:didDiscardSceneSessions:)) method.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)