***

title: Migrate your API specifications from the API Builder to Spec Hub
updated: 2026-03-01T00:00:00.000Z
max-toc-depth: 2
ux: v12
-------

<Info>
  The API Builder is deprecated and no longer supported.
</Info>

You can migrate your existing API Builder objects to Postman's [Spec Hub](/docs/design-apis/specifications/overview/) and collections. Spec Hub supports API-first development with features like reusable components, live documentation preview, and structured outline navigation. It also offers native autocompletion and syntax checking to help reduce errors as you work.

Spec Hub can generate collections from your specifications (and specifications from collections), enabling you to create [mock servers](/docs/design-apis/mock-apis/overview) and [monitor](/docs/monitoring-your-api/intro-monitors) your API. As you update your API, you can manually keep them in sync. You can also import a specification from your computer or a repository to continue building it out in Spec Hub.

Spec Hub supports [OpenAPI, AsyncAPI, protobuf, and GraphQL specifications](/docs/design-apis/specifications/overview#supported-specification-formats).

<Note>
  Spec Hub only migrates the latest cloud state of your API Builder API, and published API versions aren't migrated. For help, contact [Postman support](https://www.postman.com/support/).
</Note>

## Supported API Builder definitions

You can migrate [OpenAPI, AsyncAPI, protobuf, and GraphQL specifications](/docs/design-apis/specifications/overview#supported-specification-formats) from the API Builder to Spec Hub.

Migration doesn't support OpenAPI 1.0, RAML, or WASDL formats.

<Note>
  Your API Builder API will continue to exist in Postman version 12 and later, but you can't access. To access it, you must use the Postman v11 app.
</Note>

## Migrate from API Builder to Spec Hub

To migrate your API Builder definitions and collections to Spec Hub, do the following:

1. In the sidebar, click <img alt="Items icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/descriptive-items-stroke.svg#icon" width="20px" /> **Items** and expand **APIs**, then select the definition that you want to migrate.

2. Click <img alt="Options icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/action-options-stroke.svg#icon" width="20px" /> **View more actions > Migrate to Spec Hub**. Or click **Migrate to Spec Hub** in the upgrade notice located in the workbench. The **Select Workspace to Move API** window will appear.

3. In the **Select Workspace to Move API** window, choose whether to create a new workspace or migrate your definition into an existing workspace:

   * In the **Create a new Workspace** text box, enter a name for the new workspace.
   * Click **select an existing workspace** to select an existing workspace. Then, select a workspace from the dropdown list.

4. Click **Migrate to Spec Hub** to finish.

After the migration completes, you'll receive an in-app notification. Click **Check Workspace** or **Go to Workspace** to navigate to your migrated Spec Hub specification.

## Migrate from Git-linked API Builder to Spec Hub

Git-linked API Builder definitions are definitions connected to a remote repository. They use Git-based version control for developing and managing changes to your definition. The remote repository can be hosted in the cloud or on-premises.

To migrate a Git-linked API from API Builder to Spec Hub, do the following:

1. In the sidebar, click <img alt="Items icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/descriptive-items-stroke.svg#icon" width="20px" /> **Items** and expand **APIs**, then select the Git-linked API that you want to migrate.

2. Click <img alt="Options icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/action-options-stroke.svg#icon" width="20px" />  **View more actions > Migrate to Spec Hub**. Or click **Migrate to Spec Hub** in the upgrade notice located in the workbench. The **Select Workspace to Move API** window will appear.

3. In the **Select Workspace to Move API** window, enter the new workspace's name in the **Create a new Workspace** text box.

   <Info>
     Only one Git-linked API can be linked to a workspace.
   </Info>

4. Click **Migrate to Spec Hub**. This clones the Git repository locally so that you can access the specification and its related resources in the created workspace.

5. After the migration completes, you'll receive an in-app notification. Click **Check Workspace** or **Go to Workspace** to navigate to your migrated Spec Hub specification.

6. Click **Files** in the bottom of the sidebar. You can then choose to:

   * Click **Clone repo** to clone the repository.
   * Click **Open local folder** to access your [local files](docs/agent-mode/native-git/).

<Warning>
  API Builder definitions aren't automatically deleted after migration. Always verify all of your changes before you delete your definitions.
</Warning>