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

# Initialize google_calendar sandbox with data

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

Initialize the sandbox with google_calendar-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

- GoogleCalendarDataInput — Complete Google Calendar sandbox data structure
  - `events` GoogleCalendarEvent[], nullable — List of Google Calendar events
    - `title` string, required — Event title/summary (required)
    - `startTime` string, nullable — RFC3339 timestamp for timed events (e.g., 2025-12-01T09:00:00-07:00)
    - `endTime` string, nullable — RFC3339 timestamp for timed events
    - `startDate` string, nullable — All-day event start date in YYYY-MM-DD format
    - `endDate` string, nullable — All-day event end date in YYYY-MM-DD format
    - `timezone` string, nullable — IANA timezone (e.g., America/Los_Angeles)
    - `description` string, nullable — Event description
    - `location` string, nullable — Event location
    - `visibility` string, nullable — Visibility (default, public, private, confidential)
    - `recurrence` string[], nullable — Recurrence rules (RRULE format)
    - `attendees` GoogleCalendarAttendee[], nullable — List of event attendees
      - `email` string, email, required — Attendee email address (required)
      - `name` string, nullable — Attendee display name
      - `isOptional` boolean, nullable — Whether attendance is optional
      - `comment` string, nullable — Attendee's response comment
      - `accepted` 'needsAction' | 'declined' | 'tentative' | 'accepted' — Attendee response status for calendar events

## 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)