> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS SDK

> Migrate the FlowX iOS renderer SDK from 5.9.x to 6.0.0.

## iOS SDK migration guide

FlowX.AI 6.0 aligns the names of five iOS SDK APIs with the Android and web SDKs. The build requirements and library dependencies are unchanged, and the 5.9 names still compile, so your app builds with the 6.0 SDK after you update the pod version. Replace the deprecated names afterwards.

### System requirements

| Requirement | 5.9.x | 6.0 |
| - | - | - |
| Minimum iOS | iOS 15 | iOS 15 |
| Swift | 5.9 | 5.9 |

### Library dependencies

| Dependency | 5.9.x | 6.0 |
| - | - | - |
| [Alamofire](https://github.com/Alamofire/Alamofire) | `~> 5.9.0` | `~> 5.9.0` |
| [SDWebImageSwiftUI](https://github.com/SDWebImage/SDWebImageSwiftUI) | 3.0.3 | 3.0.3 |
| [SDWebImageSVGCoder](https://github.com/SDWebImage/SDWebImageSVGCoder) | `~> 1.7.0` | `~> 1.7.0` |

### Migration steps

**1. Update the SDK version**

```ruby Podfile theme={"dark"}
pod 'FlowXRenderer', '<5.9.x version>' # [!code --]
pod 'FlowXRenderer', '<6.0 version>' # [!code ++]
```

> [!NOTE]
>
> Find the SDK version that matches your platform version in **Release Notes → v6.0 → Deployment guidelines → Component versions**.

**2. Replace the deprecated APIs**

Replace the 5.9 names with the 6.0 names listed in the [Replace deprecated APIs](#replace-deprecated-apis) section. The parameters, types and behavior are unchanged.

### Replace deprecated APIs

The following 5.9 names still compile in 6.0, but they are deprecated and **will be removed in the next LTS release**. Replace them now:

| Deprecated (5.9) | Replacement (6.0) | Available on |
| - | - | - |
| `imageBaseURL` | `assetsBaseURL` | `FXConfig` |
| `updateAuthorization(token:)` | `setAccessToken(token:)` | `FlowX.sharedInstance` |
| `getTag(withKey:)` | `getSubstitutionTagContent(key:)` | `FlowX.sharedInstance` |
| `getEnumeration(name:parentName:)` | `getEnumerationItems(name:parentName:)` | `FlowX.sharedInstance` (async and completion versions) |
| `continueExistingProcess(uuid:name:…)` | `continueProcess(uuid:name:…)` | `FlowX.sharedInstance` (all three versions) |

> [!TIP]
>
> Xcode shows a deprecation warning on every deprecated call, with a **Fix-it** that replaces it with the new name.

These changes are reflected in an actual implementation as shown below:

```swift theme={"dark"}
// configuration
FXConfig.sharedInstance.configure { config in
    config.imageBaseURL = myImageBaseURL // [!code --]
    config.assetsBaseURL = myAssetsBaseURL // [!code ++]
}

// authorization token changes
FlowX.sharedInstance.updateAuthorization(token: accessToken) // [!code --]
FlowX.sharedInstance.setAccessToken(token: accessToken) // [!code ++]

// substitution tags
FlowX.sharedInstance.getTag(withKey: "@@close_message") // [!code --]
FlowX.sharedInstance.getSubstitutionTagContent(key: "@@close_message") // [!code ++]

// enumerations
let items = await FlowX.sharedInstance.getEnumeration(name: "cities", parentName: "countries") // [!code --]
let items = await FlowX.sharedInstance.getEnumerationItems(name: "cities", parentName: "countries") // [!code ++]

// resuming a process
FlowX.sharedInstance.continueExistingProcess(uuid: uuid, // [!code --]
FlowX.sharedInstance.continueProcess(uuid: uuid, // [!code ++]
                                     name: processName,
                                     navigationController: processNavigationController,
                                     isModal: true)
```

## Related resources

> [card] [iOS SDK reference](https://docs.flowx.ai/6.x/sdks/ios-renderer.md)
>
> iOS renderer SDK documentation

> [card] [Migration overview](https://docs.flowx.ai/release-notes/v6.x/v6.0.0-october-2026/migrating-from-v5.9-to-v6.0/migration-overview.md)
>
> Full 5.9.x → 6.0.0 container app upgrade guide


## Related topics

- [iOS SDK](https://docs.flowx.ai/6.x/sdks/ios-renderer.md)
- [SDKs overview](https://docs.flowx.ai/6.x/sdks/sdks-overview.md)
- [Overview](https://docs.flowx.ai/release-notes/v6.x/v6.0.0-october-2026/migrating-from-v5.9-to-v6.0/migration-overview.md)
- [Container app authentication](https://docs.flowx.ai/6.x/docs/saas/container-app-authentication.md)
- [FlowX.AI architecture: services, layers, and data flow](https://docs.flowx.ai/6.x/docs/platform-overview/flowx-architecture.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.