---
title: "Migration Guide from V1 to V2"
slug: "migration-guide-from-v1-to-v2"
updated: 2025-09-15T09:27:12Z
published: 2025-09-15T09:27:12Z
canonical: "knowledge-base.rossum.ai/migration-guide-from-v1-to-v2"
---

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

# Migration Guide from V1 to V2

The second version of our Sandboxing tool `prd` is **not backward compatible** with the first version. We recommend downloading the whole project again via the new version and going from there. You can keep using the old version (v1) command under `prd` and new version (v2) command under `prd2`.

To get the latest `prd` version, run the following command:

```plaintext
prd update
```

This will make the `prd2` command available, so you can initialize and download the project from scratch. First, you need to initialize a new project (in the relevant folder):

```plaintext
prd2 init
```

This command will prompt you for the following information (your options and preferences might slightly differ):

```bash
? ORG-LEVEL directory name: sandbox-org
? ORG ID: 255255
? Base API URL: (e.g., https://my-org.rossum.app/api/v1) https://example.rossum.app/api/v1
? API token: b1946ac92492d2347c6235b4d2611184
? SUBDIR name: default
? subdir regex (OPTIONAL):
? Would you like to specify another **SUBDIR** inside sandbox-org? No
? Would you like to specify another **ORG-LEVEL** directory? No
╭──────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Initialized a new PRD directory in "."                                                           │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
```

In case you made a mistake, or you want to add new folders, run the `init` command again. Later, you can pull your project configuration from the Rossum app:

```plaintext
prd2 pull sandbox-org
```

Learn more on how to work with this new version [here](/help/docs/sandboxes).

Once everything is migrated and working, you can delete the original folder structure (created via `prd`) and use the new one instead (created via `prd2`).

> [!WARNING]
> 💬 YOUR FEEDBACK MATTERS!
> 
> Help us keep this page accurate and useful. Select **Yes** or **No** below, then use the feedback form to propose a correction, ask for clarification, or request a new article.