Skip to main content

I'm seeing an error on Air Flow

Troubleshoot Air Flow with safe conflict decisions, backup precautions, and checks for content missing from your workspace.

Written by Lauren Ford

If you encounter an error in Air Flow, try the steps below in the order listed before contacting Air Support.

If content is missing, check the web workspace using the checks below before assuming it is awaiting local sync or proceeding to resync. For other errors, follow the troubleshooting steps in order and check whether the error is resolved after each step.

Important: Air Flow keeps Finder and your Air workspace in sync. When you move a synced file or folder to Finder Trash, Air Flow syncs that deletion to Air and removes the corresponding asset from the workspace, not just local storage.

  • If it’s still there, move on to the next step

  • If a different board path shows an error, restart from step 1

🔎 Check missing content in the browser

If a file or board is missing in Finder, Air Flow, or the browser, check what is available in the web workspace before resyncing.

  1. In Finder, right-click the file or board folder and select View on Air. You can also open the item from the Air Flow activity item if it appears there. If neither is available, open your workspace in the browser.

  2. Confirm the browser is signed in with the same email address and workspace that Air Flow is syncing.

  3. Confirm you have access to the relevant library or board.

  4. Clear any filters in the browser view, then refresh the page.

  5. If the item exists on the web but is missing locally, investigate local sync using the troubleshooting steps below. Back up unsynced local changes outside the Air folder before any action that could overwrite or remove them.

  6. If the item is missing from the web workspace too, check Recently Deleted and follow Recovering deleted content.

A continuing resync does not establish that no cloud deletion occurred, and resync does not guarantee recovery. If the recovery guidance does not resolve the issue, contact Air Support using the details at the end of this article.


🆕 Upgrade to the latest version of Air Flow


♻️ Retry the action by pressing the “Retry” button in the sync error pop-up

​Note: There’s no risk to selecting retry. This action tells Air's app to continue running as it is supposed to.
​

Duplicate-detected error: If the error is caused by a duplicated path in the workspace, resolve the naming conflict manually or turn on Air Flow’s automatic duplicate resolution setting to let Air Flow rename the conflicting item and continue syncing.


☁️ Pull from Cloud in the sync error pop-up

Note: Pull from cloud retrieves the item from your workspace and can overwrite unsynced local changes. Before selecting it, back up those changes to a location outside the Air folder.

If a prompt asks whether to delete the cloud item, Keep cloud version preserves that item in your workspace. Delete deletes the cloud item; it is not a local-refresh action.

After reviewing the consequence of your choice, select the remembered-decision checkbox only if you want that choice applied to future conflicts of the same type. It does not apply to all conflicts and is separate from the checkbox that deletes local data during resync.


​🎬 Restart Air Flow

Note: There’s no risk to restarting the app. All Air Flow processes will restart and pick up syncing where it last left off.

  1. Right-click the Air icon in your menu bar

  2. Click “Quit Air”

  3. Reopen Air Flow from Applications folder


🚨 Force Resync from the Air Flow app settings

Note: This action compares the current workspace state with the local filesystem and attempts to reconcile differences. Reconciliation may require conflict resolution; review the conflict choices above before deciding. This may take longer on large workspaces. This action can also risk data loss if there are any unsaved local changes in the workspace. To avoid loss of changes, save a copy of any locally stored/created items to a location outside of the Air workspace folder first.

  1. Select the Air icon in your menu bar

  2. Select the gear icon

  3. Select Force resync

  4. Select Resync​


🧹 Force resync with local data wipe

Note: This action fetches the full current state of syncing Air workspace and attempts to sync any differences. This may take longer on large workspaces. This action can also risk data loss if there are any unsaved local changes in the workspace. To avoid loss of changes, save a copy of any locally stored/created items to a location outside of the Air workspace folder first.

  1. Select the Air icon in your menu bar

  2. Select the gear icon

  3. Select Force resync

  4. Check the box to delete all local data and restart the local sync for the workspace

  5. Select Resync​


🚫 Move the workspace folder out of the Air folder and select “Pull from cloud” when prompted

Note: This action can risk data loss. To avoid loss of changes, save a copy of any locally stored/created items to a location outside of the Air workspace folder first.

  1. Move your entire workspace folder (i.e. the

    {User}/Air/{Workspace Name} folder on your computer) out of the root Air folder

  2. Click the “Pull from cloud” button in the sync status bar when prompted


If you're still experiencing problems, let us know! Email our team at help@air.inc or send a note through the messenger icon on the bottom right of this page. Include screenshots of the error, Air Flow status, Finder path, the View on Air result, and the browser page.

Did this answer your question?