<!--
{
  "availability" : [
    "iOS: 16.1.0 -",
    "iPadOS: 16.1.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ActivityKit",
  "identifier" : "/documentation/ActivityKit/ActivityAuthorizationError",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "ActivityKit"
    ],
    "preciseIdentifier" : "s:11ActivityKit0A18AuthorizationErrorO"
  },
  "title" : "ActivityAuthorizationError"
}
-->

# ActivityAuthorizationError

An error that indicates why the request to start a Live Activity failed.

```
enum ActivityAuthorizationError
```

## Topics

### Error codes

[`ActivityAuthorizationError.attributesTooLarge`](/documentation/ActivityKit/ActivityAuthorizationError/attributesTooLarge)

The provided Live Activity attributes exceeded the maximum size of 4KB.

[`ActivityAuthorizationError.denied`](/documentation/ActivityKit/ActivityAuthorizationError/denied)

A person deactivated Live Activities in Settings.

[`ActivityAuthorizationError.globalMaximumExceeded`](/documentation/ActivityKit/ActivityAuthorizationError/globalMaximumExceeded)

The device reached the maximum number of ongoing Live Activities.

[`ActivityAuthorizationError.malformedActivityIdentifier`](/documentation/ActivityKit/ActivityAuthorizationError/malformedActivityIdentifier)

The provided activity identifier is malformed.

[`ActivityAuthorizationError.missingProcessIdentifier`](/documentation/ActivityKit/ActivityAuthorizationError/missingProcessIdentifier)

The process that tried to start the Live Activity is missing a process identifier.

[`ActivityAuthorizationError.persistenceFailure`](/documentation/ActivityKit/ActivityAuthorizationError/persistenceFailure)

The system couldn’t persist the Live Activity.

[`ActivityAuthorizationError.reconnectNotPermitted`](/documentation/ActivityKit/ActivityAuthorizationError/reconnectNotPermitted)

The process that tried to recreate the Live Activity is not the process
that originally created the Live Activity.

[`ActivityAuthorizationError.targetMaximumExceeded`](/documentation/ActivityKit/ActivityAuthorizationError/targetMaximumExceeded)

The app has already started the maximum number of concurrent Live Activities.

[`ActivityAuthorizationError.unentitled`](/documentation/ActivityKit/ActivityAuthorizationError/unentitled)

The app doesn’t have the required entitlement to start a Live Activity.

[`ActivityAuthorizationError.unsupported`](/documentation/ActivityKit/ActivityAuthorizationError/unsupported)

The device doesn’t support Live Activities.

[`ActivityAuthorizationError.unsupportedTarget`](/documentation/ActivityKit/ActivityAuthorizationError/unsupportedTarget)

The app doesn’t have the required entitlement to start a Live Activities.

[`ActivityAuthorizationError.visibility`](/documentation/ActivityKit/ActivityAuthorizationError/visibility)

The app tried to start the Live Activity while it was in the background.

### Getting error information

[`failureReason`](/documentation/ActivityKit/ActivityAuthorizationError/failureReason)

A string that describes the error that occurred.

[`recoverySuggestion`](/documentation/ActivityKit/ActivityAuthorizationError/recoverySuggestion)

A localized message that describes how to recover from the error.

### Protocol confirmation

[`errorCode`](/documentation/ActivityKit/ActivityAuthorizationError/errorCode)

An integer value that represents the error code.

[`errorDomain`](/documentation/ActivityKit/ActivityAuthorizationError/errorDomain)

The domain for errors that can happen when starting a Live Activity.

## Relationships

### Conforms To

[`Sendable`](/documentation/Swift/Sendable)

[`Error`](/documentation/Swift/Error)

[`CustomNSError`](/documentation/Foundation/CustomNSError)

[`Equatable`](/documentation/Swift/Equatable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Hashable`](/documentation/Swift/Hashable)

[`LocalizedError`](/documentation/Foundation/LocalizedError)

---

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)