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

# workspace move

> Move an app to another workspace

Move an app from its current workspace into another one. The app keeps its ID, data, and owner. Only its workspace changes.

You must be an owner, admin, or editor of the target workspace, and your role in the source workspace must permit transferring apps out. Purchased apps cannot be moved. The server enforces these rules and returns an error otherwise.

By default, `workspace move` targets the app linked in the current project's [`.app.jsonc`](/developers/backend/overview/project-structure#app-jsonc). To move any other app on your account, pass [`--app-id`](/developers/references/cli/commands/introduction#select-a-target-app) or set the `BASE44_APP_ID` environment variable.

## Usage

```bash theme={null}
base44 workspace move [workspace-id]
```

In interactive mode, omit the workspace ID to pick the target from a list and confirm the move.

## Arguments

| Argument       | Description         | Required                   |
| -------------- | ------------------- | -------------------------- |
| `workspace-id` | Target workspace ID | Yes (non-interactive mode) |

## Flags

| Flag                        | Description                                                                                                                                                                   |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--app-id <id>`             | Target the specified app. Defaults to the app linked in the current project. See [Select a target app](/developers/references/cli/commands/introduction#select-a-target-app). |
| `--disconnect-integrations` | Disconnect the app's OAuth integrations as part of the move                                                                                                                   |
| `-y, --yes`                 | Skip the confirmation prompt                                                                                                                                                  |
| `--json`                    | Output the result as JSON. See [JSON output](/developers/references/cli/commands/introduction#json-output).                                                                   |

## Example

Move the linked app to a workspace:

```bash theme={null}
base44 workspace move 507f191e810c19729de860ea
```

Move a specific app without prompts:

```bash theme={null}
base44 workspace move 507f191e810c19729de860ea --app-id "your-app-id" --yes
```

## See also

* [`workspace list`](/developers/references/cli/commands/workspace-list): List the workspaces you belong to
* [`create`](/developers/references/cli/commands/create): Create a new app in a workspace