Skip to main content
POST
/
sandbox
/
google_calendar
/
{sandbox_id}
/
initialize
Initialize google_calendar sandbox with data
curl --request POST \
  --url https://api.klavis.ai/sandbox/google_calendar/{sandbox_id}/initialize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "title": "Team Standup",
      "description": "Daily team standup meeting to discuss progress and blockers",
      "startTime": "2025-12-01T09:00:00-08:00",
      "endTime": "2025-12-01T09:30:00-08:00",
      "timezone": "America/Los_Angeles",
      "attendees": [
        {
          "email": "team@example.com"
        }
      ]
    },
    {
      "title": "Client Meeting - Q4 Review",
      "description": "Quarterly business review with key client stakeholders",
      "location": "Conference Room A",
      "startTime": "2025-12-02T14:00:00-08:00",
      "endTime": "2025-12-02T15:30:00-08:00",
      "timezone": "America/Los_Angeles",
      "attendees": [
        {
          "email": "client@example.com"
        },
        {
          "email": "sales@example.com"
        }
      ],
      "visibility": "private"
    },
    {
      "title": "Project Planning Session",
      "description": "Q1 2026 project planning and resource allocation",
      "location": "Main Office - Building 2",
      "startTime": "2025-12-03T10:00:00-08:00",
      "endTime": "2025-12-03T12:00:00-08:00",
      "timezone": "America/Los_Angeles",
      "attendees": [
        {
          "email": "team@example.com"
        },
        {
          "email": "manager@example.com"
        },
        {
          "email": "product@example.com",
          "isOptional": true
        }
      ]
    },
    {
      "title": "One-on-One with Manager",
      "description": "Monthly check-in and career development discussion",
      "startTime": "2025-12-05T15:00:00-08:00",
      "endTime": "2025-12-05T15:30:00-08:00",
      "timezone": "America/Los_Angeles",
      "attendees": [
        {
          "email": "manager@example.com"
        }
      ],
      "visibility": "private"
    },
    {
      "title": "Team Lunch",
      "description": "Team building lunch and informal catch-up",
      "location": "Restaurant Downtown",
      "startTime": "2025-12-07T12:00:00-08:00",
      "endTime": "2025-12-07T13:30:00-08:00",
      "timezone": "America/Los_Angeles",
      "attendees": [
        {
          "email": "team@example.com"
        }
      ]
    },
    {
      "title": "All-Day Company Offsite",
      "description": "Annual company offsite for strategic planning",
      "location": "Retreat Center",
      "startDate": "2025-12-10",
      "endDate": "2025-12-11",
      "attendees": [
        {
          "email": "everyone@example.com"
        }
      ]
    },
    {
      "title": "Product Demo Webinar",
      "description": "Public webinar showcasing new product features",
      "startTime": "2025-12-12T11:00:00-08:00",
      "endTime": "2025-12-12T12:00:00-08:00",
      "timezone": "America/Los_Angeles",
      "attendees": [
        {
          "email": "marketing@example.com"
        },
        {
          "email": "product@example.com"
        }
      ],
      "visibility": "public"
    },
    {
      "title": "Sprint Retrospective",
      "description": "Reflect on the sprint and identify improvements",
      "startTime": "2025-12-13T16:00:00-08:00",
      "endTime": "2025-12-13T17:00:00-08:00",
      "timezone": "America/Los_Angeles",
      "attendees": [
        {
          "email": "team@example.com"
        },
        {
          "email": "scrum-master@example.com"
        }
      ]
    },
    {
      "title": "Budget Review - Finance",
      "description": "Q4 budget review and variance analysis",
      "location": "Finance Conference Room",
      "startTime": "2025-12-15T13:00:00-08:00",
      "endTime": "2025-12-15T14:30:00-08:00",
      "timezone": "America/Los_Angeles",
      "attendees": [
        {
          "email": "finance@example.com"
        },
        {
          "email": "manager@example.com"
        }
      ],
      "visibility": "confidential"
    },
    {
      "title": "Holiday Party Planning",
      "description": "Planning meeting for the annual holiday celebration",
      "startTime": "2025-12-18T14:00:00-08:00",
      "endTime": "2025-12-18T15:00:00-08:00",
      "timezone": "America/Los_Angeles",
      "attendees": [
        {
          "email": "events@example.com"
        },
        {
          "email": "hr@example.com"
        }
      ]
    }
  ]
}
'
import requests

url = "https://api.klavis.ai/sandbox/google_calendar/{sandbox_id}/initialize"

payload = { "events": [
        {
            "title": "Team Standup",
            "description": "Daily team standup meeting to discuss progress and blockers",
            "startTime": "2025-12-01T09:00:00-08:00",
            "endTime": "2025-12-01T09:30:00-08:00",
            "timezone": "America/Los_Angeles",
            "attendees": [{ "email": "team@example.com" }]
        },
        {
            "title": "Client Meeting - Q4 Review",
            "description": "Quarterly business review with key client stakeholders",
            "location": "Conference Room A",
            "startTime": "2025-12-02T14:00:00-08:00",
            "endTime": "2025-12-02T15:30:00-08:00",
            "timezone": "America/Los_Angeles",
            "attendees": [{ "email": "client@example.com" }, { "email": "sales@example.com" }],
            "visibility": "private"
        },
        {
            "title": "Project Planning Session",
            "description": "Q1 2026 project planning and resource allocation",
            "location": "Main Office - Building 2",
            "startTime": "2025-12-03T10:00:00-08:00",
            "endTime": "2025-12-03T12:00:00-08:00",
            "timezone": "America/Los_Angeles",
            "attendees": [
                { "email": "team@example.com" },
                { "email": "manager@example.com" },
                {
                    "email": "product@example.com",
                    "isOptional": True
                }
            ]
        },
        {
            "title": "One-on-One with Manager",
            "description": "Monthly check-in and career development discussion",
            "startTime": "2025-12-05T15:00:00-08:00",
            "endTime": "2025-12-05T15:30:00-08:00",
            "timezone": "America/Los_Angeles",
            "attendees": [{ "email": "manager@example.com" }],
            "visibility": "private"
        },
        {
            "title": "Team Lunch",
            "description": "Team building lunch and informal catch-up",
            "location": "Restaurant Downtown",
            "startTime": "2025-12-07T12:00:00-08:00",
            "endTime": "2025-12-07T13:30:00-08:00",
            "timezone": "America/Los_Angeles",
            "attendees": [{ "email": "team@example.com" }]
        },
        {
            "title": "All-Day Company Offsite",
            "description": "Annual company offsite for strategic planning",
            "location": "Retreat Center",
            "startDate": "2025-12-10",
            "endDate": "2025-12-11",
            "attendees": [{ "email": "everyone@example.com" }]
        },
        {
            "title": "Product Demo Webinar",
            "description": "Public webinar showcasing new product features",
            "startTime": "2025-12-12T11:00:00-08:00",
            "endTime": "2025-12-12T12:00:00-08:00",
            "timezone": "America/Los_Angeles",
            "attendees": [{ "email": "marketing@example.com" }, { "email": "product@example.com" }],
            "visibility": "public"
        },
        {
            "title": "Sprint Retrospective",
            "description": "Reflect on the sprint and identify improvements",
            "startTime": "2025-12-13T16:00:00-08:00",
            "endTime": "2025-12-13T17:00:00-08:00",
            "timezone": "America/Los_Angeles",
            "attendees": [{ "email": "team@example.com" }, { "email": "scrum-master@example.com" }]
        },
        {
            "title": "Budget Review - Finance",
            "description": "Q4 budget review and variance analysis",
            "location": "Finance Conference Room",
            "startTime": "2025-12-15T13:00:00-08:00",
            "endTime": "2025-12-15T14:30:00-08:00",
            "timezone": "America/Los_Angeles",
            "attendees": [{ "email": "finance@example.com" }, { "email": "manager@example.com" }],
            "visibility": "confidential"
        },
        {
            "title": "Holiday Party Planning",
            "description": "Planning meeting for the annual holiday celebration",
            "startTime": "2025-12-18T14:00:00-08:00",
            "endTime": "2025-12-18T15:00:00-08:00",
            "timezone": "America/Los_Angeles",
            "attendees": [{ "email": "events@example.com" }, { "email": "hr@example.com" }]
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    events: [
      {
        title: 'Team Standup',
        description: 'Daily team standup meeting to discuss progress and blockers',
        startTime: '2025-12-01T09:00:00-08:00',
        endTime: '2025-12-01T09:30:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'team@example.com'}]
      },
      {
        title: 'Client Meeting - Q4 Review',
        description: 'Quarterly business review with key client stakeholders',
        location: 'Conference Room A',
        startTime: '2025-12-02T14:00:00-08:00',
        endTime: '2025-12-02T15:30:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'client@example.com'}, {email: 'sales@example.com'}],
        visibility: 'private'
      },
      {
        title: 'Project Planning Session',
        description: 'Q1 2026 project planning and resource allocation',
        location: 'Main Office - Building 2',
        startTime: '2025-12-03T10:00:00-08:00',
        endTime: '2025-12-03T12:00:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [
          {email: 'team@example.com'},
          {email: 'manager@example.com'},
          {email: 'product@example.com', isOptional: true}
        ]
      },
      {
        title: 'One-on-One with Manager',
        description: 'Monthly check-in and career development discussion',
        startTime: '2025-12-05T15:00:00-08:00',
        endTime: '2025-12-05T15:30:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'manager@example.com'}],
        visibility: 'private'
      },
      {
        title: 'Team Lunch',
        description: 'Team building lunch and informal catch-up',
        location: 'Restaurant Downtown',
        startTime: '2025-12-07T12:00:00-08:00',
        endTime: '2025-12-07T13:30:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'team@example.com'}]
      },
      {
        title: 'All-Day Company Offsite',
        description: 'Annual company offsite for strategic planning',
        location: 'Retreat Center',
        startDate: '2025-12-10',
        endDate: '2025-12-11',
        attendees: [{email: 'everyone@example.com'}]
      },
      {
        title: 'Product Demo Webinar',
        description: 'Public webinar showcasing new product features',
        startTime: '2025-12-12T11:00:00-08:00',
        endTime: '2025-12-12T12:00:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'marketing@example.com'}, {email: 'product@example.com'}],
        visibility: 'public'
      },
      {
        title: 'Sprint Retrospective',
        description: 'Reflect on the sprint and identify improvements',
        startTime: '2025-12-13T16:00:00-08:00',
        endTime: '2025-12-13T17:00:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'team@example.com'}, {email: 'scrum-master@example.com'}]
      },
      {
        title: 'Budget Review - Finance',
        description: 'Q4 budget review and variance analysis',
        location: 'Finance Conference Room',
        startTime: '2025-12-15T13:00:00-08:00',
        endTime: '2025-12-15T14:30:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'finance@example.com'}, {email: 'manager@example.com'}],
        visibility: 'confidential'
      },
      {
        title: 'Holiday Party Planning',
        description: 'Planning meeting for the annual holiday celebration',
        startTime: '2025-12-18T14:00:00-08:00',
        endTime: '2025-12-18T15:00:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'events@example.com'}, {email: 'hr@example.com'}]
      }
    ]
  })
};

fetch('https://api.klavis.ai/sandbox/google_calendar/{sandbox_id}/initialize', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    events: [
      {
        title: 'Team Standup',
        description: 'Daily team standup meeting to discuss progress and blockers',
        startTime: '2025-12-01T09:00:00-08:00',
        endTime: '2025-12-01T09:30:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'team@example.com'}]
      },
      {
        title: 'Client Meeting - Q4 Review',
        description: 'Quarterly business review with key client stakeholders',
        location: 'Conference Room A',
        startTime: '2025-12-02T14:00:00-08:00',
        endTime: '2025-12-02T15:30:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'client@example.com'}, {email: 'sales@example.com'}],
        visibility: 'private'
      },
      {
        title: 'Project Planning Session',
        description: 'Q1 2026 project planning and resource allocation',
        location: 'Main Office - Building 2',
        startTime: '2025-12-03T10:00:00-08:00',
        endTime: '2025-12-03T12:00:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [
          {email: 'team@example.com'},
          {email: 'manager@example.com'},
          {email: 'product@example.com', isOptional: true}
        ]
      },
      {
        title: 'One-on-One with Manager',
        description: 'Monthly check-in and career development discussion',
        startTime: '2025-12-05T15:00:00-08:00',
        endTime: '2025-12-05T15:30:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'manager@example.com'}],
        visibility: 'private'
      },
      {
        title: 'Team Lunch',
        description: 'Team building lunch and informal catch-up',
        location: 'Restaurant Downtown',
        startTime: '2025-12-07T12:00:00-08:00',
        endTime: '2025-12-07T13:30:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'team@example.com'}]
      },
      {
        title: 'All-Day Company Offsite',
        description: 'Annual company offsite for strategic planning',
        location: 'Retreat Center',
        startDate: '2025-12-10',
        endDate: '2025-12-11',
        attendees: [{email: 'everyone@example.com'}]
      },
      {
        title: 'Product Demo Webinar',
        description: 'Public webinar showcasing new product features',
        startTime: '2025-12-12T11:00:00-08:00',
        endTime: '2025-12-12T12:00:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'marketing@example.com'}, {email: 'product@example.com'}],
        visibility: 'public'
      },
      {
        title: 'Sprint Retrospective',
        description: 'Reflect on the sprint and identify improvements',
        startTime: '2025-12-13T16:00:00-08:00',
        endTime: '2025-12-13T17:00:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'team@example.com'}, {email: 'scrum-master@example.com'}]
      },
      {
        title: 'Budget Review - Finance',
        description: 'Q4 budget review and variance analysis',
        location: 'Finance Conference Room',
        startTime: '2025-12-15T13:00:00-08:00',
        endTime: '2025-12-15T14:30:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'finance@example.com'}, {email: 'manager@example.com'}],
        visibility: 'confidential'
      },
      {
        title: 'Holiday Party Planning',
        description: 'Planning meeting for the annual holiday celebration',
        startTime: '2025-12-18T14:00:00-08:00',
        endTime: '2025-12-18T15:00:00-08:00',
        timezone: 'America/Los_Angeles',
        attendees: [{email: 'events@example.com'}, {email: 'hr@example.com'}]
      }
    ]
  })
};

fetch('https://api.klavis.ai/sandbox/google_calendar/{sandbox_id}/initialize', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "sandbox_id": "<string>",
  "message": "<string>"
}
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

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 Google Calendar sandbox data structure

​
events
GoogleCalendarEvent · object[] | null

List of Google Calendar events

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