---
title: "activateSceneSession(for:errorHandler:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uiapplication/activatescenesession(for:errorhandler:)"
---

# activateSceneSession(for:errorHandler:)

Asks the system to activate an existing scene or create a new scene and associate it with your app.

## Declaration

```swift
@MainActor @preconcurrency func activateSceneSession(for request: UISceneSessionActivationRequest, errorHandler: ((any Error) -> Void)? = nil)
```

## Parameters

- `request`: The activation request.
- `errorHandler`: A handler to call if the request fails.

## See Also

### Related Documentation

- [requestSceneSessionActivation(_:userActivity:options:errorHandler:)](uikit/uiapplication/requestscenesessionactivation(_:useractivity:options:errorhandler:).md)

### Managing a scene’s life cycle

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