curl --request POST \
--url https://api.klavis.ai/sandbox/notion/{sandbox_id}/initialize \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"databases": [
{
"name": "Product Roadmap",
"summary": "Track product features and releases",
"display_icon": "🚀",
"sources": [
{
"label": "Features",
"summary": "Feature tracking table",
"fields": {
"Name": {
"type": "title"
},
"Status": {
"type": "select",
"options": [
"Planning",
"In Progress",
"Done"
]
},
"Priority": {
"type": "select",
"options": [
"High",
"Medium",
"Low"
]
},
"Assignee": {
"type": "people"
}
},
"pages": [
{
"name": "User Authentication",
"attributes": {
"Status": "Done",
"Priority": "High"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Implement secure user authentication with OAuth2 support"
},
{
"block_type": "heading_2",
"content": "Requirements"
},
{
"block_type": "bulleted_list_item",
"content": "Support email/password login"
},
{
"block_type": "bulleted_list_item",
"content": "Implement JWT tokens"
},
{
"block_type": "bulleted_list_item",
"content": "Add OAuth2 providers (Google, GitHub)"
}
],
"comments": [
{
"content": "Should we support social login from day one?"
},
{
"content": "Yes, let's add Google and GitHub OAuth"
}
]
},
{
"name": "Real-time Notifications",
"attributes": {
"Status": "In Progress",
"Priority": "High"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Build real-time notification system using WebSockets"
},
{
"block_type": "to_do",
"content": "Set up WebSocket server"
},
{
"block_type": "to_do",
"content": "Create notification service"
},
{
"block_type": "to_do",
"content": "Design notification UI components"
}
],
"comments": []
},
{
"name": "Dark Mode Support",
"attributes": {
"Status": "Planning",
"Priority": "Medium"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Add dark mode theme toggle"
},
{
"block_type": "callout",
"content": "💡 Consider using CSS variables for easy theme switching"
}
],
"comments": [
{
"content": "Users have been requesting this feature frequently"
}
]
}
]
},
{
"label": "Releases",
"summary": "Release planning and tracking",
"fields": {
"Name": {
"type": "title"
},
"Release Date": {
"type": "date"
},
"Status": {
"type": "select",
"options": [
"Planned",
"In Development",
"Released"
]
}
},
"pages": [
{
"name": "v1.0 - MVP Release",
"attributes": {
"Release Date": "2024-03-15",
"Status": "In Development"
},
"content_blocks": [
{
"block_type": "heading_2",
"content": "Release Goals"
},
{
"block_type": "paragraph",
"content": "First production-ready version with core functionality"
},
{
"block_type": "numbered_list_item",
"content": "User authentication and authorization"
},
{
"block_type": "numbered_list_item",
"content": "Real-time notifications"
},
{
"block_type": "numbered_list_item",
"content": "Core API endpoints"
}
],
"comments": []
},
{
"name": "v1.1 - Enhanced UX",
"attributes": {
"Release Date": "2024-04-30",
"Status": "Planned"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Focus on user experience improvements"
}
],
"comments": []
}
]
}
]
},
{
"name": "Team Tasks",
"summary": "Daily task management for the team",
"display_icon": "✅",
"sources": [
{
"label": "Tasks",
"summary": "Task tracking",
"fields": {
"Task": {
"type": "title"
},
"Status": {
"type": "status"
},
"Assignee": {
"type": "people"
},
"Due Date": {
"type": "date"
},
"Priority": {
"type": "select",
"options": [
"High",
"Medium",
"Low"
]
}
},
"pages": [
{
"name": "Review pull request #123",
"attributes": {
"Status": "In Progress",
"Priority": "High",
"Due Date": "2024-02-10"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Review authentication implementation PR"
},
{
"block_type": "code",
"content": "// Check for proper error handling and security best practices"
}
],
"comments": [
{
"content": "Found a potential security issue in token validation"
},
{
"content": "Fixed in latest commit"
}
]
},
{
"name": "Update deployment documentation",
"attributes": {
"Status": "Todo",
"Priority": "Medium",
"Due Date": "2024-02-15"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Add new deployment steps for Docker setup"
}
],
"comments": []
},
{
"name": "Fix responsive layout on mobile",
"attributes": {
"Status": "Done",
"Priority": "High",
"Due Date": "2024-02-08"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Navigation menu was broken on screens < 768px"
},
{
"block_type": "heading_3",
"content": "Solution"
},
{
"block_type": "paragraph",
"content": "Implemented hamburger menu for mobile devices"
}
],
"comments": [
{
"content": "Tested on iPhone and Android devices, looks good!"
}
]
}
]
}
]
}
],
"pages": [
{
"name": "Team Meeting Notes - Feb 2024",
"content_blocks": [
{
"block_type": "heading_1",
"content": "Weekly Sync - February 5, 2024"
},
{
"block_type": "paragraph",
"content": "Attendees: Alice, Bob, Charlie, Diana"
},
{
"block_type": "heading_2",
"content": "Discussion Points"
},
{
"block_type": "bulleted_list_item",
"content": "Sprint retrospective review"
},
{
"block_type": "bulleted_list_item",
"content": "Q1 roadmap planning"
},
{
"block_type": "bulleted_list_item",
"content": "New hire onboarding process"
},
{
"block_type": "heading_2",
"content": "Action Items"
},
{
"block_type": "to_do",
"content": "Alice: Schedule 1-on-1s with new team members"
},
{
"block_type": "to_do",
"content": "Bob: Update API documentation"
},
{
"block_type": "to_do",
"content": "Charlie: Review security audit findings"
}
],
"comments": [
{
"content": "Great meeting! Let's make sure we follow up on action items by Friday"
},
{
"content": "Added calendar invites for the 1-on-1s"
}
]
},
{
"name": "Engineering Wiki Home",
"content_blocks": [
{
"block_type": "heading_1",
"content": "Welcome to Engineering Wiki"
},
{
"block_type": "paragraph",
"content": "This wiki contains all technical documentation, guides, and best practices for our engineering team."
},
{
"block_type": "heading_2",
"content": "Quick Links"
},
{
"block_type": "bulleted_list_item",
"content": "Getting Started Guide"
},
{
"block_type": "bulleted_list_item",
"content": "API Documentation"
},
{
"block_type": "bulleted_list_item",
"content": "Architecture Overview"
},
{
"block_type": "bulleted_list_item",
"content": "Deployment Procedures"
},
{
"block_type": "heading_2",
"content": "Code of Conduct"
},
{
"block_type": "quote",
"content": "Write code that is clear, maintainable, and well-tested. When in doubt, prioritize readability over cleverness."
}
],
"comments": []
},
{
"name": "API Design Guidelines",
"content_blocks": [
{
"block_type": "heading_1",
"content": "REST API Design Guidelines"
},
{
"block_type": "paragraph",
"content": "Follow these guidelines when designing new API endpoints"
},
{
"block_type": "heading_2",
"content": "General Principles"
},
{
"block_type": "numbered_list_item",
"content": "Use RESTful conventions (GET, POST, PUT, DELETE)"
},
{
"block_type": "numbered_list_item",
"content": "Use plural nouns for resource names"
},
{
"block_type": "numbered_list_item",
"content": "Version your APIs (e.g., /v1/users)"
},
{
"block_type": "numbered_list_item",
"content": "Use HTTP status codes correctly"
},
{
"block_type": "heading_2",
"content": "Example"
},
{
"block_type": "code",
"content": "GET /v1/users - List all users\nGET /v1/users/:id - Get specific user\nPOST /v1/users - Create new user\nPUT /v1/users/:id - Update user\nDELETE /v1/users/:id - Delete user"
},
{
"block_type": "callout",
"content": "⚠️ Always validate input data and sanitize user-provided content"
}
],
"comments": [
{
"content": "Should we use GraphQL for more complex queries?"
},
{
"content": "Let's discuss in next architecture meeting"
}
]
}
]
}
EOF{
"sandbox_id": "<string>",
"status": "idle",
"message": "<string>"
}Initialize the sandbox with notion-specific data following the defined schema.
curl --request POST \
--url https://api.klavis.ai/sandbox/notion/{sandbox_id}/initialize \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"databases": [
{
"name": "Product Roadmap",
"summary": "Track product features and releases",
"display_icon": "🚀",
"sources": [
{
"label": "Features",
"summary": "Feature tracking table",
"fields": {
"Name": {
"type": "title"
},
"Status": {
"type": "select",
"options": [
"Planning",
"In Progress",
"Done"
]
},
"Priority": {
"type": "select",
"options": [
"High",
"Medium",
"Low"
]
},
"Assignee": {
"type": "people"
}
},
"pages": [
{
"name": "User Authentication",
"attributes": {
"Status": "Done",
"Priority": "High"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Implement secure user authentication with OAuth2 support"
},
{
"block_type": "heading_2",
"content": "Requirements"
},
{
"block_type": "bulleted_list_item",
"content": "Support email/password login"
},
{
"block_type": "bulleted_list_item",
"content": "Implement JWT tokens"
},
{
"block_type": "bulleted_list_item",
"content": "Add OAuth2 providers (Google, GitHub)"
}
],
"comments": [
{
"content": "Should we support social login from day one?"
},
{
"content": "Yes, let's add Google and GitHub OAuth"
}
]
},
{
"name": "Real-time Notifications",
"attributes": {
"Status": "In Progress",
"Priority": "High"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Build real-time notification system using WebSockets"
},
{
"block_type": "to_do",
"content": "Set up WebSocket server"
},
{
"block_type": "to_do",
"content": "Create notification service"
},
{
"block_type": "to_do",
"content": "Design notification UI components"
}
],
"comments": []
},
{
"name": "Dark Mode Support",
"attributes": {
"Status": "Planning",
"Priority": "Medium"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Add dark mode theme toggle"
},
{
"block_type": "callout",
"content": "💡 Consider using CSS variables for easy theme switching"
}
],
"comments": [
{
"content": "Users have been requesting this feature frequently"
}
]
}
]
},
{
"label": "Releases",
"summary": "Release planning and tracking",
"fields": {
"Name": {
"type": "title"
},
"Release Date": {
"type": "date"
},
"Status": {
"type": "select",
"options": [
"Planned",
"In Development",
"Released"
]
}
},
"pages": [
{
"name": "v1.0 - MVP Release",
"attributes": {
"Release Date": "2024-03-15",
"Status": "In Development"
},
"content_blocks": [
{
"block_type": "heading_2",
"content": "Release Goals"
},
{
"block_type": "paragraph",
"content": "First production-ready version with core functionality"
},
{
"block_type": "numbered_list_item",
"content": "User authentication and authorization"
},
{
"block_type": "numbered_list_item",
"content": "Real-time notifications"
},
{
"block_type": "numbered_list_item",
"content": "Core API endpoints"
}
],
"comments": []
},
{
"name": "v1.1 - Enhanced UX",
"attributes": {
"Release Date": "2024-04-30",
"Status": "Planned"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Focus on user experience improvements"
}
],
"comments": []
}
]
}
]
},
{
"name": "Team Tasks",
"summary": "Daily task management for the team",
"display_icon": "✅",
"sources": [
{
"label": "Tasks",
"summary": "Task tracking",
"fields": {
"Task": {
"type": "title"
},
"Status": {
"type": "status"
},
"Assignee": {
"type": "people"
},
"Due Date": {
"type": "date"
},
"Priority": {
"type": "select",
"options": [
"High",
"Medium",
"Low"
]
}
},
"pages": [
{
"name": "Review pull request #123",
"attributes": {
"Status": "In Progress",
"Priority": "High",
"Due Date": "2024-02-10"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Review authentication implementation PR"
},
{
"block_type": "code",
"content": "// Check for proper error handling and security best practices"
}
],
"comments": [
{
"content": "Found a potential security issue in token validation"
},
{
"content": "Fixed in latest commit"
}
]
},
{
"name": "Update deployment documentation",
"attributes": {
"Status": "Todo",
"Priority": "Medium",
"Due Date": "2024-02-15"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Add new deployment steps for Docker setup"
}
],
"comments": []
},
{
"name": "Fix responsive layout on mobile",
"attributes": {
"Status": "Done",
"Priority": "High",
"Due Date": "2024-02-08"
},
"content_blocks": [
{
"block_type": "paragraph",
"content": "Navigation menu was broken on screens < 768px"
},
{
"block_type": "heading_3",
"content": "Solution"
},
{
"block_type": "paragraph",
"content": "Implemented hamburger menu for mobile devices"
}
],
"comments": [
{
"content": "Tested on iPhone and Android devices, looks good!"
}
]
}
]
}
]
}
],
"pages": [
{
"name": "Team Meeting Notes - Feb 2024",
"content_blocks": [
{
"block_type": "heading_1",
"content": "Weekly Sync - February 5, 2024"
},
{
"block_type": "paragraph",
"content": "Attendees: Alice, Bob, Charlie, Diana"
},
{
"block_type": "heading_2",
"content": "Discussion Points"
},
{
"block_type": "bulleted_list_item",
"content": "Sprint retrospective review"
},
{
"block_type": "bulleted_list_item",
"content": "Q1 roadmap planning"
},
{
"block_type": "bulleted_list_item",
"content": "New hire onboarding process"
},
{
"block_type": "heading_2",
"content": "Action Items"
},
{
"block_type": "to_do",
"content": "Alice: Schedule 1-on-1s with new team members"
},
{
"block_type": "to_do",
"content": "Bob: Update API documentation"
},
{
"block_type": "to_do",
"content": "Charlie: Review security audit findings"
}
],
"comments": [
{
"content": "Great meeting! Let's make sure we follow up on action items by Friday"
},
{
"content": "Added calendar invites for the 1-on-1s"
}
]
},
{
"name": "Engineering Wiki Home",
"content_blocks": [
{
"block_type": "heading_1",
"content": "Welcome to Engineering Wiki"
},
{
"block_type": "paragraph",
"content": "This wiki contains all technical documentation, guides, and best practices for our engineering team."
},
{
"block_type": "heading_2",
"content": "Quick Links"
},
{
"block_type": "bulleted_list_item",
"content": "Getting Started Guide"
},
{
"block_type": "bulleted_list_item",
"content": "API Documentation"
},
{
"block_type": "bulleted_list_item",
"content": "Architecture Overview"
},
{
"block_type": "bulleted_list_item",
"content": "Deployment Procedures"
},
{
"block_type": "heading_2",
"content": "Code of Conduct"
},
{
"block_type": "quote",
"content": "Write code that is clear, maintainable, and well-tested. When in doubt, prioritize readability over cleverness."
}
],
"comments": []
},
{
"name": "API Design Guidelines",
"content_blocks": [
{
"block_type": "heading_1",
"content": "REST API Design Guidelines"
},
{
"block_type": "paragraph",
"content": "Follow these guidelines when designing new API endpoints"
},
{
"block_type": "heading_2",
"content": "General Principles"
},
{
"block_type": "numbered_list_item",
"content": "Use RESTful conventions (GET, POST, PUT, DELETE)"
},
{
"block_type": "numbered_list_item",
"content": "Use plural nouns for resource names"
},
{
"block_type": "numbered_list_item",
"content": "Version your APIs (e.g., /v1/users)"
},
{
"block_type": "numbered_list_item",
"content": "Use HTTP status codes correctly"
},
{
"block_type": "heading_2",
"content": "Example"
},
{
"block_type": "code",
"content": "GET /v1/users - List all users\nGET /v1/users/:id - Get specific user\nPOST /v1/users - Create new user\nPUT /v1/users/:id - Update user\nDELETE /v1/users/:id - Delete user"
},
{
"block_type": "callout",
"content": "⚠️ Always validate input data and sanitize user-provided content"
}
],
"comments": [
{
"content": "Should we use GraphQL for more complex queries?"
},
{
"content": "Let's discuss in next architecture meeting"
}
]
}
]
}
EOF{
"sandbox_id": "<string>",
"status": "idle",
"message": "<string>"
}Documentation Index
Fetch the complete documentation index at: https://www.klavis.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
Your Klavis AI API key.
The unique sandbox identifier
If true, use default test data for initialization
Complete Notion sandbox data structure.
Hierarchical structure for initialization:
Relational structure: