---
title: "beginActivity(options:reason:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/processinfo/beginactivity(options:reason:)"
---

# beginActivity(options:reason:)

Begin an activity using the given options and reason.

## Declaration

```swift
func beginActivity(options: ProcessInfo.ActivityOptions = [], reason: String) -> any NSObjectProtocol
```

## Parameters

- `options`: Options for the activity. See doc://com.apple.foundation/documentation/Foundation/ProcessInfo/ActivityOptions for possible values.
- `reason`: A string used in debugging to indicate the reason the activity began.

## Return Value

Return Value An object token representing the activity.

## Discussion

Discussion Indicate completion of the activity by calling endActivity(_:) passing the returned object as the argument.

## See Also

### Managing activities

- [endActivity(_:)](foundation/processinfo/endactivity(_:).md)
- [performActivity(options:reason:using:)](foundation/processinfo/performactivity(options:reason:using:).md)
- [performExpiringActivity(withReason:using:)](foundation/processinfo/performexpiringactivity(withreason:using:).md)
- [ProcessInfo.ActivityOptions](foundation/processinfo/activityoptions.md)