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

# Initialize google_forms sandbox with data

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

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

- GoogleFormsDataInput — Complete Google Forms sandbox data structure
  - `forms` GoogleFormsFormInput[] — List of Google Forms
    - `title` string, required — The form title visible to responders
    - `description` string, nullable — The form description
    - `is_quiz` boolean — Whether this form is a quiz
    - `items` GoogleFormsItemInput[] — List of form items (questions and section headers)
      - `item_type` 'question' | 'section_header', required — Type of form item
      - `question` GoogleFormsQuestion — A question item in the form - simplified structure
        - `title` string, required — The question title/prompt
        - `description` string, nullable — Additional description for the question
        - `required` boolean — Whether this question is required
        - `question_type` 'short_text' | 'paragraph' | 'multiple_choice' | 'checkbox' | 'dropdown' | 'scale' | 'date' | 'time', required — The type of question
        - `options` GoogleFormsChoiceOption[], nullable — List of options for choice-based questions
          - `value` string, required — The text value of the choice option
        - `scale_low` integer, nullable — Low end of scale (for scale questions)
        - `scale_high` integer, nullable — High end of scale (for scale questions)
        - `scale_low_label` string, nullable — Label for low end of scale
        - `scale_high_label` string, nullable — Label for high end of scale
        - `include_year` boolean, nullable — Whether to include year in date questions
        - `include_time` boolean, nullable — Whether to include time in date questions
      - `section_header` GoogleFormsSectionHeader — A section header/text item in the form
        - `title` string, required — The section title
        - `description` string, nullable — Section description

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