---
title: "update(_:)"
framework: AudioAccessoryKit
role: symbol
role_heading: Instance Method
platforms: [iOS 26.4+]
path: "audioaccessorykit/accessorycontroldevice/update(_:)"
---

# update(_:)

Updates the accessory’s configuration.

## Declaration

```swift
final nonisolated(nonsending) func update(_ configuration: AccessoryControlDevice.Configuration) async throws
```

## Parameters

- `configuration`: The new configuration to apply.

## Discussion

Discussion important: Call this method only from your app extension. For example, the following code updates device placement: // Get the current state. let accessoryDevice = try AccessoryControlDevice.current(for: myAccessory)

// Modify the configuration with new values. var configuration = accessoryDevice.configuration configuration.devicePlacement = .onHead

// Apply the updated configuration. try await accessoryDevice.update(configuration) print("Successfully updated device configuration") Always register a capability before trying to update it. For example, the code above is valid only if you included the placement capability when registering the accessory. This method throws an error if the update fails.