---
title: "Initialize clickup sandbox with data"
method: POST
path: "/sandbox/clickup/{sandbox_id}/initialize"
tags: ["sandbox"]
---

# Initialize clickup sandbox with data

`POST /sandbox/clickup/{sandbox_id}/initialize`

Initialize the sandbox with clickup-specific data following the defined schema.

## Path parameters

- `sandbox_id` string, required — The unique sandbox identifier

## Query parameters

- `init_default_data` boolean — If true, use default test data for initialization

## Request body

- ClickUpDataInput — Complete ClickUp sandbox data structure. Nested hierarchy for initialization: - Spaces contain Folders and Lists (folderless) - Folders contain Lists - Lists contain Tasks - Tasks contain Comments
  - `spaces` ClickUpSpaceInput[], nullable — List of spaces with nested objects
    - `name` string, required — Space name
    - `folders` ClickUpFolderInput[], nullable — Folders in this space
      - `name` string, required — Folder name
      - `lists` ClickUpListInput[], nullable — Lists in this folder
        - `name` string, required — List name
        - `description` string, nullable — List description
        - `tasks` ClickUpTaskInput[], nullable — Tasks in this list
          - `name` string, required — Task name
          - `description` string, nullable — Task description
          - `priority` integer, nullable — Task priority (1-4)
          - `comments` ClickUpComment[], nullable — Comments on this task
            - `body` string, required — Comment body content
    - `lists` ClickUpListInput[], nullable — Folderless lists in this space
      - `name` string, required — List name
      - `description` string, nullable — List description
      - `tasks` ClickUpTaskInput[], nullable — Tasks in this list
        - `name` string, required — Task name
        - `description` string, nullable — Task description
        - `priority` integer, nullable — Task priority (1-4)
        - `comments` ClickUpComment[], nullable — Comments on this task
          - `body` string, required — Comment body content

## Response `200`

Successful Response

- InitializeSandboxResponse — Response model for sandbox initialization
  - `sandbox_id` string, required — Sandbox identifier
  - `status` 'idle' | 'occupied' | 'error', required — Status of a sandbox instance - matches database enum
  - `message` string, required — Initialization result message

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/klavis-ai/apis/klavis-ai-https-www-klavis-ai.md) · [All operations](https://skmtc.net/klavis-ai/apis/klavis-ai-https-www-klavis-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/klavis-ai/klavis-ai-https-www-klavis-ai/versions/1f05ced7280f/schema)