---
title: Activity
framework: activitykit
role: symbol
role_heading: Class
path: activitykit/activity
---

# Activity

The object you use to start, update, and end a Live Activity.

## Declaration

```swift
class Activity<Attributes> where Attributes : ActivityAttributes
```

## Mentioned in

Displaying live data with Live Activities

## Overview

Overview The Activity object offers functionality to start, update, and end a Live Activity from within your app. You can update or end a Live Activity while your app is in the background, but you can only start a Live Activity while the app is in the foreground, unless you adopt App Intents and start the Live Activity using a LiveActivityIntent. Additionally, Activity offers functionality to observe changes to: The Live Activity The Live Activity’s state in its life cycle A person’s permission to start Live Activities The Live Activity’s push token if you configure it to receive updates through ActivityKit push notifications. To observe these changes, use the asynchronous sequences the activity object offers; for example, use the activityStateUpdates sequence to observe changes to the state of a Live Activity.

## Topics

### Starting a Live Activity

- [request(attributes:content:pushType:)](activitykit/activity/request(attributes:content:pushtype:).md)
- [request(attributes:content:pushType:style:)](activitykit/activity/request(attributes:content:pushtype:style:).md)
- [request(attributes:content:pushType:style:alertConfiguration:start:)](activitykit/activity/request(attributes:content:pushtype:style:alertconfiguration:start:).md)
- [request(attributes:content:pushType:style:alertConfiguration:startDate:)](activitykit/activity/request(attributes:content:pushtype:style:alertconfiguration:startdate:).md)
- [attributes](activitykit/activity/attributes.md)
- [ActivityAttributes](activitykit/activityattributes.md)
- [ActivityStyle](activitykit/activitystyle.md)
- [content](activitykit/activity/content.md)
- [ActivityContent](activitykit/activitycontent.md)
- [Activity.ContentState](activitykit/activity/contentstate-swift.typealias.md)
- [PushType](activitykit/pushtype.md)
- [ActivityAuthorizationError](activitykit/activityauthorizationerror.md)

### Updating a Live Activity

- [update(_:)](activitykit/activity/update(_:).md)
- [update(_:alertConfiguration:)](activitykit/activity/update(_:alertconfiguration:).md)
- [AlertConfiguration](activitykit/alertconfiguration.md)
- [update(_:alertConfiguration:timestamp:)](activitykit/activity/update(_:alertconfiguration:timestamp:).md)

### Ending a Live Activity

- [end(_:dismissalPolicy:)](activitykit/activity/end(_:dismissalpolicy:).md)
- [ActivityUIDismissalPolicy](activitykit/activityuidismissalpolicy.md)
- [end(_:dismissalPolicy:timestamp:)](activitykit/activity/end(_:dismissalpolicy:timestamp:).md)

### Observing Live Activity content changes

- [contentUpdates](activitykit/activity/contentupdates-swift.property.md)
- [Activity.ContentUpdates](activitykit/activity/contentupdates-swift.struct.md)

### Observing the Live Activity life cycle

- [activityState](activitykit/activity/activitystate.md)
- [ActivityState](activitykit/activitystate.md)
- [activityStateUpdates](activitykit/activity/activitystateupdates-swift.property.md)
- [Activity.ActivityStateUpdates](activitykit/activity/activitystateupdates-swift.struct.md)

### Using ActivityKit push notifications

- [pushToken](activitykit/activity/pushtoken.md)
- [pushTokenUpdates](activitykit/activity/pushtokenupdates-swift.property.md)
- [Activity.PushTokenUpdates](activitykit/activity/pushtokenupdates-swift.struct.md)
- [pushToStartToken](activitykit/activity/pushtostarttoken.md)
- [pushToStartTokenUpdates](activitykit/activity/pushtostarttokenupdates.md)

### Checking user authorization

- [ActivityAuthorizationInfo](activitykit/activityauthorizationinfo.md)

### Accessing Live Activities

- [activities](activitykit/activity/activities.md)
- [activityUpdates](activitykit/activity/activityupdates-swift.type.property.md)
- [Activity.ActivityUpdates](activitykit/activity/activityupdates-swift.struct.md)

### Identifying a Live Activity

- [id](activitykit/activity/id.md)
- [id](activitykit/activity/id.md)

### Deprecated

- [Deprecated symbols](activitykit/deprecated-symbols.md)

## Relationships

### Conforms To

- [Identifiable](swift/identifiable.md)

## See Also

### Starting a Live Activity

- [Displaying live data with Live Activities](activitykit/displaying-live-data-with-live-activities.md)
- [Starting and updating Live Activities with ActivityKit push notifications](activitykit/starting-and-updating-live-activities-with-activitykit-push-notifications.md)
- [Emoji Rangers: Supporting Live Activities, interactivity, and animations](widgetkit/emoji-rangers-supporting-live-activities-interactivity-and-animations.md)
- [NSSupportsLiveActivities](bundleresources/information-property-list/nssupportsliveactivities.md)
- [NSSupportsLiveActivitiesFrequentUpdates](bundleresources/information-property-list/nssupportsliveactivitiesfrequentupdates.md)