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
{
  "sandbox_id": "<string>",
  "status": "idle",
  "message": "<string>",
  "records_created": {}
}

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
message
string
required

Initialization result message

records_created
Records Created · object

Count of records created per object type