Page updated Nov 15, 2023

Create, update, and delete application data

Amplify iOS v1 is now in Maintenance Mode until May 31st, 2024. This means that we will continue to include updates to ensure compatibility with backend services and security. No new features will be introduced in v1.

Please use the latest version (v2) of Amplify Library for Swift to get started.

If you are currently using v1, follow these instructions to upgrade to v2.

Run a mutation

Now that the client is set up, you can run a GraphQL mutation with Amplify.API.mutate to create, update, and delete your data.

Make sure you have the following imports at the top of your file

import Amplify import AWSPluginsCore
1import Amplify
2import AWSPluginsCore
func updateTodo() { // Retrieve your Todo using Amplify.API.query var todo = Todo(name: "my first todo", description: "todo description") todo.description = "updated description" Amplify.API.mutate(request: .update(todo)) { event in switch event { case .success(let result): switch result { case .success(let todo): print("Successfully created todo: \(todo)") case .failure(let error): print("Got failed result with \(error.errorDescription)") } case .failure(let error): print("Got failed event with error \(error)") } } }
1func updateTodo() {
2 // Retrieve your Todo using Amplify.API.query
3 var todo = Todo(name: "my first todo", description: "todo description")
4 todo.description = "updated description"
5 Amplify.API.mutate(request: .update(todo)) { event in
6 switch event {
7 case .success(let result):
8 switch result {
9 case .success(let todo):
10 print("Successfully created todo: \(todo)")
11 case .failure(let error):
12 print("Got failed result with \(error.errorDescription)")
13 }
14 case .failure(let error):
15 print("Got failed event with error \(error)")
16 }
17 }
18}

To create data, replace the request with .create

Amplify.API.mutate(request: .create(todo))
1Amplify.API.mutate(request: .create(todo))

To delete data, replace the request with .delete

Amplify.API.mutate(request: .delete(todo))
1Amplify.API.mutate(request: .delete(todo))