---
title: "Import a JSON bundle into a workspace"
method: POST
path: "/importBundle"
tags: ["Bundle"]
---

# Import a JSON bundle into a workspace

`POST /importBundle`

## Request

- Base URL: `https://www.taskade.com/api/v2`
- URL: `https://www.taskade.com/api/v2/importBundle`
- Auth: OAuth 2 and HTTP bearer
  - Authorization code: `https://www.taskade.com/oauth2/authorize`
  - Token URL: `https://www.taskade.com/oauth2/token`

## Request body

- object
  - `workspaceId` string, required: The target workspace ID to import the bundle into.
  - `bundleData` object, required: The Workspace DNA bundle to import (SpaceBundleData v1).
    - `version` '1', required: Bundle format version.
    - `items` object, required: Map of bundle items keyed by ID. Each item has a `type` field: space-bundle-flow-item, space-bundle-project-item, space-bundle-agent-item, space-bundle-template-item, space-bundle-media-item, space-bundle-app-item, space-bundle-agent-team-item. Agent-team items name their members by SOURCE agent id in `agentIds`; the importer remaps them and drops any member whose agent is not also in the bundle.

## Response `200`

Default response

- object
  - `ok` true, required
  - `item` BundleInstallation, required
    - `id` string, required: Unique identifier for the bundle installation.
    - `projectCount` number, required: Number of projects installed.
    - `flowCount` number, required: Number of automations installed.
    - `agentCount` number, required: Number of agents installed.
    - `templateCount` number, required: Number of templates installed.
    - `mediaCount` number, required: Number of media files installed.
    - `appCount` number, required: Number of apps installed.

---

[API](https://skmtc.dev/taskade/apis/taskade-public-api-v2.md) - [All operations](https://skmtc.dev/taskade/apis/taskade-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/taskade/apis/taskade-public-api-v2/revisions/45f0e74ec083?raw)