Skip to main content
POST
/
sandbox
/
wordpress
/
{sandbox_id}
/
initialize
Initialize wordpress sandbox with data
curl --request POST \
  --url https://api.klavis.ai/sandbox/wordpress/{sandbox_id}/initialize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "posts": [
    {
      "title": "Welcome to Klavis AI WordPress Integration",
      "content": "<p>This is the first test post created through Klavis AI's WordPress sandbox.</p><p>We're testing the full CRUD functionality with WordPress.com REST API v1.1.</p><p>Key features being tested:</p><ul><li>Post creation with multiple statuses</li><li>Categories and tags management</li><li>Different post formats</li><li>Content formatting with HTML</li></ul>",
      "status": "publish",
      "summary": "Testing Klavis AI WordPress sandbox integration with full CRUD support",
      "categories": [
        "Technology",
        "Integration",
        "API"
      ],
      "tags": [
        "klavis",
        "wordpress",
        "mcp",
        "testing",
        "rest-api"
      ],
      "format": "standard"
    },
    {
      "title": "Understanding MCP (Model Context Protocol)",
      "content": "<h2>What is MCP?</h2><p>The Model Context Protocol (MCP) is a revolutionary approach to AI integrations.</p><h3>Key Benefits</h3><ul><li>Standardized integration patterns</li><li>Secure authentication flows</li><li>Sandbox testing environments</li><li>Rate limiting and error handling</li></ul><blockquote>MCP enables AI agents to reliably interact with 100+ tools at scale.</blockquote>",
      "status": "publish",
      "summary": "Learn about the Model Context Protocol and how it revolutionizes AI integrations",
      "categories": [
        "Technology",
        "Education"
      ],
      "tags": [
        "mcp",
        "ai",
        "protocol",
        "integration"
      ],
      "format": "standard"
    },
    {
      "title": "Draft Post: Future Features Roadmap",
      "content": "<p>This is a draft post about upcoming features in the WordPress sandbox...</p><h3>Planned Features</h3><ul><li><strong>Pages Support</strong>: Create and manage WordPress pages</li><li><strong>Media Management</strong>: Upload and attach featured images</li><li><strong>Comments</strong>: Handle post comments via API</li><li><strong>Custom Post Types</strong>: Support for custom content types</li><li><strong>Post Relationships</strong>: Parent/child post hierarchies</li></ul><p>Stay tuned for updates!</p>",
      "status": "draft",
      "summary": "Planning future WordPress integration features and enhancements",
      "categories": [
        "Product Updates",
        "Roadmap"
      ],
      "tags": [
        "roadmap",
        "features",
        "planning"
      ],
      "format": "standard"
    },
    {
      "title": "Quick Note: Integration Best Practices",
      "content": "<p>A quick aside about best practices when integrating with WordPress.com API:</p><ol><li>Always handle rate limits gracefully</li><li>Use OAuth 2.0 for authentication</li><li>Validate data before sending to API</li><li>Normalize responses for consistency</li></ol>",
      "status": "publish",
      "summary": "Best practices for WordPress API integration",
      "categories": [
        "Documentation"
      ],
      "tags": [
        "notes",
        "quick",
        "best-practices"
      ],
      "format": "aside"
    },
    {
      "title": "Image Gallery: Integration Screenshots",
      "content": "<p>This post showcases screenshots of the integration process.</p><p>[Gallery would go here with multiple images showing the OAuth flow, sandbox dashboard, and API responses]</p>",
      "status": "publish",
      "summary": "Visual guide to WordPress integration",
      "categories": [
        "Documentation",
        "Visual"
      ],
      "tags": [
        "gallery",
        "screenshots",
        "visual"
      ],
      "format": "gallery"
    },
    {
      "title": "Link: WordPress REST API Documentation",
      "content": "<p>Check out the official WordPress.com REST API documentation for more details:</p><p><a href=\"https://developer.wordpress.com/docs/api/\">https://developer.wordpress.com/docs/api/</a></p>",
      "status": "publish",
      "categories": [
        "Resources"
      ],
      "tags": [
        "link",
        "documentation",
        "reference"
      ],
      "format": "link"
    },
    {
      "title": "Inspirational Quote",
      "content": "<blockquote>\"The best way to predict the future is to implement it.\" - Klavis AI Team</blockquote><p>This quote inspires our approach to building robust integrations.</p>",
      "status": "publish",
      "categories": [
        "Inspiration"
      ],
      "tags": [
        "quote",
        "inspiration"
      ],
      "format": "quote"
    },
    {
      "title": "Private Internal Note",
      "content": "<p>This is a private post for internal team use only.</p><p>Internal metrics:</p><ul><li>OAuth completion rate: 98%</li><li>API success rate: 99.5%</li><li>Average response time: 250ms</li></ul>",
      "status": "private",
      "summary": "Internal metrics and notes",
      "categories": [
        "Internal"
      ],
      "tags": [
        "private",
        "metrics",
        "internal"
      ],
      "format": "standard"
    },
    {
      "title": "Testing Categories and Tags",
      "content": "<p>This post tests extensive categorization and tagging capabilities.</p><p>WordPress allows multiple categories and tags per post, which we're testing here.</p>",
      "status": "publish",
      "summary": "Testing multi-category and multi-tag support",
      "categories": [
        "Testing",
        "Quality Assurance",
        "Automation",
        "CI/CD"
      ],
      "tags": [
        "test",
        "qa",
        "automation",
        "categories",
        "tags",
        "metadata"
      ],
      "format": "standard"
    },
    {
      "title": "Draft: Pending Review Article",
      "content": "<p>This article is pending editorial review before publication.</p><p>It covers advanced topics in WordPress automation and sandbox testing.</p>",
      "status": "pending",
      "summary": "Advanced WordPress automation topics - pending review",
      "categories": [
        "Advanced"
      ],
      "tags": [
        "pending",
        "review",
        "advanced"
      ],
      "format": "standard"
    }
  ]
}
EOF
import requests

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

payload = { "posts": [
        {
            "title": "Welcome to Klavis AI WordPress Integration",
            "content": "<p>This is the first test post created through Klavis AI's WordPress sandbox.</p><p>We're testing the full CRUD functionality with WordPress.com REST API v1.1.</p><p>Key features being tested:</p><ul><li>Post creation with multiple statuses</li><li>Categories and tags management</li><li>Different post formats</li><li>Content formatting with HTML</li></ul>",
            "status": "publish",
            "summary": "Testing Klavis AI WordPress sandbox integration with full CRUD support",
            "categories": ["Technology", "Integration", "API"],
            "tags": ["klavis", "wordpress", "mcp", "testing", "rest-api"],
            "format": "standard"
        },
        {
            "title": "Understanding MCP (Model Context Protocol)",
            "content": "<h2>What is MCP?</h2><p>The Model Context Protocol (MCP) is a revolutionary approach to AI integrations.</p><h3>Key Benefits</h3><ul><li>Standardized integration patterns</li><li>Secure authentication flows</li><li>Sandbox testing environments</li><li>Rate limiting and error handling</li></ul><blockquote>MCP enables AI agents to reliably interact with 100+ tools at scale.</blockquote>",
            "status": "publish",
            "summary": "Learn about the Model Context Protocol and how it revolutionizes AI integrations",
            "categories": ["Technology", "Education"],
            "tags": ["mcp", "ai", "protocol", "integration"],
            "format": "standard"
        },
        {
            "title": "Draft Post: Future Features Roadmap",
            "content": "<p>This is a draft post about upcoming features in the WordPress sandbox...</p><h3>Planned Features</h3><ul><li><strong>Pages Support</strong>: Create and manage WordPress pages</li><li><strong>Media Management</strong>: Upload and attach featured images</li><li><strong>Comments</strong>: Handle post comments via API</li><li><strong>Custom Post Types</strong>: Support for custom content types</li><li><strong>Post Relationships</strong>: Parent/child post hierarchies</li></ul><p>Stay tuned for updates!</p>",
            "status": "draft",
            "summary": "Planning future WordPress integration features and enhancements",
            "categories": ["Product Updates", "Roadmap"],
            "tags": ["roadmap", "features", "planning"],
            "format": "standard"
        },
        {
            "title": "Quick Note: Integration Best Practices",
            "content": "<p>A quick aside about best practices when integrating with WordPress.com API:</p><ol><li>Always handle rate limits gracefully</li><li>Use OAuth 2.0 for authentication</li><li>Validate data before sending to API</li><li>Normalize responses for consistency</li></ol>",
            "status": "publish",
            "summary": "Best practices for WordPress API integration",
            "categories": ["Documentation"],
            "tags": ["notes", "quick", "best-practices"],
            "format": "aside"
        },
        {
            "title": "Image Gallery: Integration Screenshots",
            "content": "<p>This post showcases screenshots of the integration process.</p><p>[Gallery would go here with multiple images showing the OAuth flow, sandbox dashboard, and API responses]</p>",
            "status": "publish",
            "summary": "Visual guide to WordPress integration",
            "categories": ["Documentation", "Visual"],
            "tags": ["gallery", "screenshots", "visual"],
            "format": "gallery"
        },
        {
            "title": "Link: WordPress REST API Documentation",
            "content": "<p>Check out the official WordPress.com REST API documentation for more details:</p><p><a href=\"https://developer.wordpress.com/docs/api/\">https://developer.wordpress.com/docs/api/</a></p>",
            "status": "publish",
            "categories": ["Resources"],
            "tags": ["link", "documentation", "reference"],
            "format": "link"
        },
        {
            "title": "Inspirational Quote",
            "content": "<blockquote>\"The best way to predict the future is to implement it.\" - Klavis AI Team</blockquote><p>This quote inspires our approach to building robust integrations.</p>",
            "status": "publish",
            "categories": ["Inspiration"],
            "tags": ["quote", "inspiration"],
            "format": "quote"
        },
        {
            "title": "Private Internal Note",
            "content": "<p>This is a private post for internal team use only.</p><p>Internal metrics:</p><ul><li>OAuth completion rate: 98%</li><li>API success rate: 99.5%</li><li>Average response time: 250ms</li></ul>",
            "status": "private",
            "summary": "Internal metrics and notes",
            "categories": ["Internal"],
            "tags": ["private", "metrics", "internal"],
            "format": "standard"
        },
        {
            "title": "Testing Categories and Tags",
            "content": "<p>This post tests extensive categorization and tagging capabilities.</p><p>WordPress allows multiple categories and tags per post, which we're testing here.</p>",
            "status": "publish",
            "summary": "Testing multi-category and multi-tag support",
            "categories": ["Testing", "Quality Assurance", "Automation", "CI/CD"],
            "tags": ["test", "qa", "automation", "categories", "tags", "metadata"],
            "format": "standard"
        },
        {
            "title": "Draft: Pending Review Article",
            "content": "<p>This article is pending editorial review before publication.</p><p>It covers advanced topics in WordPress automation and sandbox testing.</p>",
            "status": "pending",
            "summary": "Advanced WordPress automation topics - pending review",
            "categories": ["Advanced"],
            "tags": ["pending", "review", "advanced"],
            "format": "standard"
        }
    ] }
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({
    posts: [
      {
        title: 'Welcome to Klavis AI WordPress Integration',
        content: '<p>This is the first test post created through Klavis AI\'s WordPress sandbox.</p><p>We\'re testing the full CRUD functionality with WordPress.com REST API v1.1.</p><p>Key features being tested:</p><ul><li>Post creation with multiple statuses</li><li>Categories and tags management</li><li>Different post formats</li><li>Content formatting with HTML</li></ul>',
        status: 'publish',
        summary: 'Testing Klavis AI WordPress sandbox integration with full CRUD support',
        categories: ['Technology', 'Integration', 'API'],
        tags: ['klavis', 'wordpress', 'mcp', 'testing', 'rest-api'],
        format: 'standard'
      },
      {
        title: 'Understanding MCP (Model Context Protocol)',
        content: '<h2>What is MCP?</h2><p>The Model Context Protocol (MCP) is a revolutionary approach to AI integrations.</p><h3>Key Benefits</h3><ul><li>Standardized integration patterns</li><li>Secure authentication flows</li><li>Sandbox testing environments</li><li>Rate limiting and error handling</li></ul><blockquote>MCP enables AI agents to reliably interact with 100+ tools at scale.</blockquote>',
        status: 'publish',
        summary: 'Learn about the Model Context Protocol and how it revolutionizes AI integrations',
        categories: ['Technology', 'Education'],
        tags: ['mcp', 'ai', 'protocol', 'integration'],
        format: 'standard'
      },
      {
        title: 'Draft Post: Future Features Roadmap',
        content: '<p>This is a draft post about upcoming features in the WordPress sandbox...</p><h3>Planned Features</h3><ul><li><strong>Pages Support</strong>: Create and manage WordPress pages</li><li><strong>Media Management</strong>: Upload and attach featured images</li><li><strong>Comments</strong>: Handle post comments via API</li><li><strong>Custom Post Types</strong>: Support for custom content types</li><li><strong>Post Relationships</strong>: Parent/child post hierarchies</li></ul><p>Stay tuned for updates!</p>',
        status: 'draft',
        summary: 'Planning future WordPress integration features and enhancements',
        categories: ['Product Updates', 'Roadmap'],
        tags: ['roadmap', 'features', 'planning'],
        format: 'standard'
      },
      {
        title: 'Quick Note: Integration Best Practices',
        content: '<p>A quick aside about best practices when integrating with WordPress.com API:</p><ol><li>Always handle rate limits gracefully</li><li>Use OAuth 2.0 for authentication</li><li>Validate data before sending to API</li><li>Normalize responses for consistency</li></ol>',
        status: 'publish',
        summary: 'Best practices for WordPress API integration',
        categories: ['Documentation'],
        tags: ['notes', 'quick', 'best-practices'],
        format: 'aside'
      },
      {
        title: 'Image Gallery: Integration Screenshots',
        content: '<p>This post showcases screenshots of the integration process.</p><p>[Gallery would go here with multiple images showing the OAuth flow, sandbox dashboard, and API responses]</p>',
        status: 'publish',
        summary: 'Visual guide to WordPress integration',
        categories: ['Documentation', 'Visual'],
        tags: ['gallery', 'screenshots', 'visual'],
        format: 'gallery'
      },
      {
        title: 'Link: WordPress REST API Documentation',
        content: '<p>Check out the official WordPress.com REST API documentation for more details:</p><p><a href="https://developer.wordpress.com/docs/api/">https://developer.wordpress.com/docs/api/</a></p>',
        status: 'publish',
        categories: ['Resources'],
        tags: ['link', 'documentation', 'reference'],
        format: 'link'
      },
      {
        title: 'Inspirational Quote',
        content: '<blockquote>"The best way to predict the future is to implement it." - Klavis AI Team</blockquote><p>This quote inspires our approach to building robust integrations.</p>',
        status: 'publish',
        categories: ['Inspiration'],
        tags: ['quote', 'inspiration'],
        format: 'quote'
      },
      {
        title: 'Private Internal Note',
        content: '<p>This is a private post for internal team use only.</p><p>Internal metrics:</p><ul><li>OAuth completion rate: 98%</li><li>API success rate: 99.5%</li><li>Average response time: 250ms</li></ul>',
        status: 'private',
        summary: 'Internal metrics and notes',
        categories: ['Internal'],
        tags: ['private', 'metrics', 'internal'],
        format: 'standard'
      },
      {
        title: 'Testing Categories and Tags',
        content: '<p>This post tests extensive categorization and tagging capabilities.</p><p>WordPress allows multiple categories and tags per post, which we\'re testing here.</p>',
        status: 'publish',
        summary: 'Testing multi-category and multi-tag support',
        categories: ['Testing', 'Quality Assurance', 'Automation', 'CI/CD'],
        tags: ['test', 'qa', 'automation', 'categories', 'tags', 'metadata'],
        format: 'standard'
      },
      {
        title: 'Draft: Pending Review Article',
        content: '<p>This article is pending editorial review before publication.</p><p>It covers advanced topics in WordPress automation and sandbox testing.</p>',
        status: 'pending',
        summary: 'Advanced WordPress automation topics - pending review',
        categories: ['Advanced'],
        tags: ['pending', 'review', 'advanced'],
        format: 'standard'
      }
    ]
  })
};

fetch('https://api.klavis.ai/sandbox/wordpress/{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({
    posts: [
      {
        title: 'Welcome to Klavis AI WordPress Integration',
        content: '<p>This is the first test post created through Klavis AI\'s WordPress sandbox.</p><p>We\'re testing the full CRUD functionality with WordPress.com REST API v1.1.</p><p>Key features being tested:</p><ul><li>Post creation with multiple statuses</li><li>Categories and tags management</li><li>Different post formats</li><li>Content formatting with HTML</li></ul>',
        status: 'publish',
        summary: 'Testing Klavis AI WordPress sandbox integration with full CRUD support',
        categories: ['Technology', 'Integration', 'API'],
        tags: ['klavis', 'wordpress', 'mcp', 'testing', 'rest-api'],
        format: 'standard'
      },
      {
        title: 'Understanding MCP (Model Context Protocol)',
        content: '<h2>What is MCP?</h2><p>The Model Context Protocol (MCP) is a revolutionary approach to AI integrations.</p><h3>Key Benefits</h3><ul><li>Standardized integration patterns</li><li>Secure authentication flows</li><li>Sandbox testing environments</li><li>Rate limiting and error handling</li></ul><blockquote>MCP enables AI agents to reliably interact with 100+ tools at scale.</blockquote>',
        status: 'publish',
        summary: 'Learn about the Model Context Protocol and how it revolutionizes AI integrations',
        categories: ['Technology', 'Education'],
        tags: ['mcp', 'ai', 'protocol', 'integration'],
        format: 'standard'
      },
      {
        title: 'Draft Post: Future Features Roadmap',
        content: '<p>This is a draft post about upcoming features in the WordPress sandbox...</p><h3>Planned Features</h3><ul><li><strong>Pages Support</strong>: Create and manage WordPress pages</li><li><strong>Media Management</strong>: Upload and attach featured images</li><li><strong>Comments</strong>: Handle post comments via API</li><li><strong>Custom Post Types</strong>: Support for custom content types</li><li><strong>Post Relationships</strong>: Parent/child post hierarchies</li></ul><p>Stay tuned for updates!</p>',
        status: 'draft',
        summary: 'Planning future WordPress integration features and enhancements',
        categories: ['Product Updates', 'Roadmap'],
        tags: ['roadmap', 'features', 'planning'],
        format: 'standard'
      },
      {
        title: 'Quick Note: Integration Best Practices',
        content: '<p>A quick aside about best practices when integrating with WordPress.com API:</p><ol><li>Always handle rate limits gracefully</li><li>Use OAuth 2.0 for authentication</li><li>Validate data before sending to API</li><li>Normalize responses for consistency</li></ol>',
        status: 'publish',
        summary: 'Best practices for WordPress API integration',
        categories: ['Documentation'],
        tags: ['notes', 'quick', 'best-practices'],
        format: 'aside'
      },
      {
        title: 'Image Gallery: Integration Screenshots',
        content: '<p>This post showcases screenshots of the integration process.</p><p>[Gallery would go here with multiple images showing the OAuth flow, sandbox dashboard, and API responses]</p>',
        status: 'publish',
        summary: 'Visual guide to WordPress integration',
        categories: ['Documentation', 'Visual'],
        tags: ['gallery', 'screenshots', 'visual'],
        format: 'gallery'
      },
      {
        title: 'Link: WordPress REST API Documentation',
        content: '<p>Check out the official WordPress.com REST API documentation for more details:</p><p><a href="https://developer.wordpress.com/docs/api/">https://developer.wordpress.com/docs/api/</a></p>',
        status: 'publish',
        categories: ['Resources'],
        tags: ['link', 'documentation', 'reference'],
        format: 'link'
      },
      {
        title: 'Inspirational Quote',
        content: '<blockquote>"The best way to predict the future is to implement it." - Klavis AI Team</blockquote><p>This quote inspires our approach to building robust integrations.</p>',
        status: 'publish',
        categories: ['Inspiration'],
        tags: ['quote', 'inspiration'],
        format: 'quote'
      },
      {
        title: 'Private Internal Note',
        content: '<p>This is a private post for internal team use only.</p><p>Internal metrics:</p><ul><li>OAuth completion rate: 98%</li><li>API success rate: 99.5%</li><li>Average response time: 250ms</li></ul>',
        status: 'private',
        summary: 'Internal metrics and notes',
        categories: ['Internal'],
        tags: ['private', 'metrics', 'internal'],
        format: 'standard'
      },
      {
        title: 'Testing Categories and Tags',
        content: '<p>This post tests extensive categorization and tagging capabilities.</p><p>WordPress allows multiple categories and tags per post, which we\'re testing here.</p>',
        status: 'publish',
        summary: 'Testing multi-category and multi-tag support',
        categories: ['Testing', 'Quality Assurance', 'Automation', 'CI/CD'],
        tags: ['test', 'qa', 'automation', 'categories', 'tags', 'metadata'],
        format: 'standard'
      },
      {
        title: 'Draft: Pending Review Article',
        content: '<p>This article is pending editorial review before publication.</p><p>It covers advanced topics in WordPress automation and sandbox testing.</p>',
        status: 'pending',
        summary: 'Advanced WordPress automation topics - pending review',
        categories: ['Advanced'],
        tags: ['pending', 'review', 'advanced'],
        format: 'standard'
      }
    ]
  })
};

fetch('https://api.klavis.ai/sandbox/wordpress/{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

WordPress sandbox data structure

​
posts
Post · object[]

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