---
title: "POST /bundles/{workspaceId}/import"
method: POST
path: "/bundles/{workspaceId}/import"
tags: ["Bundle"]
---

# POST /bundles/{workspaceId}/import

`POST /bundles/{workspaceId}/import`

## Request

- Base URL: `https://www.taskade.com/api/v1`
- URL: `https://www.taskade.com/api/v1/bundles/{workspaceId}/import`
- Auth: OAuth 2 and HTTP bearer
  - Authorization code: `https://www.taskade.com/oauth2/authorize`
  - Token URL: `https://www.taskade.com/oauth2/token`

Import a JSON bundle (agents, automations, projects, templates, apps) into a workspace. The bundle is validated against the SpaceBundleData v1 schema and all items are installed into the target workspace. Media items are not supported — use the ZIP import or upload media separately via the media endpoints after import.

## Path parameters

- `workspaceId` string, required

## Request body

- object
  - `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`

Successful bundle import

- object: Successful bundle import
  - `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.

## Other responses

- `4XX`: Error description

---

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