Skip to main content
POST
/
sandbox
/
monday
/
{sandbox_id}
/
initialize
Initialize monday sandbox with data
curl --request POST \
  --url https://api.klavis.ai/sandbox/monday/{sandbox_id}/initialize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspaces": [
    {
      "name": "Product Development",
      "kind": "open",
      "description": "Main workspace for product development and engineering teams"
    },
    {
      "name": "Marketing & Sales",
      "kind": "open",
      "description": "Workspace for marketing campaigns and sales tracking"
    }
  ],
  "boards": [
    {
      "name": "Sprint Planning Q1",
      "description": "Agile sprint planning and task tracking for Q1 2024",
      "board_kind": "public",
      "groups": [
        {
          "title": "Backlog",
          "color": "#808080",
          "items": [
            {
              "name": "Research new authentication methods",
              "column_values": {
                "status": "Not Started",
                "priority": "Low"
              },
              "updates": [
                {
                  "body": "Need to evaluate OAuth 2.0, SAML, and WebAuthn"
                }
              ]
            }
          ]
        },
        {
          "title": "Sprint 1 - Foundation",
          "color": "#0086c0",
          "items": [
            {
              "name": "Set up project repository",
              "column_values": {
                "status": "Done",
                "priority": "High"
              },
              "updates": [
                {
                  "body": "Repository created on GitHub with proper branch protection rules"
                }
              ],
              "subitems": [
                {
                  "name": "Initialize Git repository"
                }
              ]
            },
            {
              "name": "Implement user authentication",
              "column_values": {
                "status": "Working on it",
                "priority": "Critical"
              },
              "updates": [
                {
                  "body": "Started with JWT token implementation"
                }
              ],
              "subitems": [
                {
                  "name": "Implement JWT authentication"
                }
              ]
            }
          ]
        },
        {
          "title": "Completed",
          "color": "#00d647",
          "items": [
            {
              "name": "Initial project kickoff",
              "column_values": {
                "status": "Done",
                "priority": "High"
              },
              "updates": [
                {
                  "body": "Successful kickoff meeting with all stakeholders"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "name": "Bug Tracker",
      "description": "Track and manage software bugs and issues",
      "board_kind": "public",
      "groups": [
        {
          "title": "New Bugs",
          "color": "#e44258",
          "items": [
            {
              "name": "Login fails on Safari browser",
              "column_values": {
                "status": "New",
                "priority": "Critical",
                "severity": "High"
              },
              "updates": [
                {
                  "body": "Reported by 3 users, reproducible on Safari 17+"
                }
              ]
            }
          ]
        },
        {
          "title": "In Progress",
          "color": "#fdab3d",
          "items": [
            {
              "name": "API timeout on large data requests",
              "column_values": {
                "status": "Investigating",
                "priority": "High",
                "severity": "Medium"
              },
              "updates": [
                {
                  "body": "Identified slow database query as root cause"
                }
              ],
              "subitems": [
                {
                  "name": "Add database indexes"
                }
              ]
            }
          ]
        },
        {
          "title": "Closed",
          "color": "#c4c4c4",
          "items": [
            {
              "name": "Dark mode toggle not working",
              "column_values": {
                "status": "Closed",
                "priority": "Medium",
                "severity": "Low"
              },
              "updates": [
                {
                  "body": "Fixed in version 1.2.0"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "name": "Marketing Campaigns 2024",
      "description": "Marketing campaign planning and execution",
      "board_kind": "public",
      "groups": [
        {
          "title": "Q1 Campaigns",
          "color": "#9cd326",
          "items": [
            {
              "name": "Spring Product Launch",
              "column_values": {
                "status": "In Progress",
                "budget": "$50000"
              },
              "updates": [
                {
                  "body": "Landing page design completed"
                }
              ],
              "subitems": [
                {
                  "name": "Create landing page"
                }
              ]
            }
          ]
        },
        {
          "title": "Q2 Planning",
          "color": "#037f4c",
          "items": [
            {
              "name": "Summer Webinar Series",
              "column_values": {
                "status": "Planning",
                "budget": "$25000"
              },
              "updates": [
                {
                  "body": "Brainstorming topics with product team"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "name": "Customer Success",
      "description": "Customer onboarding and support initiatives",
      "board_kind": "public",
      "groups": [
        {
          "title": "Enterprise Clients",
          "color": "#784bd1",
          "items": [
            {
              "name": "Acme Corp - Onboarding",
              "column_values": {
                "status": "In Progress",
                "account_value": "$250000"
              },
              "updates": [
                {
                  "body": "Kickoff call completed, 50 user licenses purchased"
                }
              ],
              "subitems": [
                {
                  "name": "Initial training session"
                }
              ]
            }
          ]
        },
        {
          "title": "SMB Clients",
          "color": "#579bfc",
          "items": [
            {
              "name": "Digital Agency Co - Support",
              "column_values": {
                "status": "Active",
                "account_value": "$5000"
              },
              "updates": [
                {
                  "body": "Monthly check-in call completed"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
'
{
  "sandbox_id": "<string>",
  "status": "idle",
  "message": "<string>",
  "records_created": {}
}

Authorizations

Authorization
string
header
required

Your Klavis AI API key.

Path Parameters

sandbox_id
string
required

The unique sandbox identifier

Query Parameters

init_default_data
boolean
default:false

If true, use default test data for initialization

Body

application/json

Complete Monday.com sandbox data structure.

Relational structure for initialization:

  • Workspaces (optional, can be created separately)
  • Boards contain Groups
  • Groups contain Items
  • Items contain Updates and Subitems

All objects support DELETE operations.

workspaces
MondayWorkspace · object[] | null

List of workspaces

boards
MondayBoard · object[]

List of boards with their groups and items

Response

Successful Response

Response model for sandbox initialization

sandbox_id
string
required

Sandbox identifier

status
enum<string>
required

Current status

Available options:
idle,
occupied,
error
message
string
required

Initialization result message

records_created
Records Created · object

Count of records created per object type