{
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "What is machine learning?"}
  ],
  "model": "claude-sonnet-4.6",
  "stream": false,
  "max_tokens": 1000,
  "temperature": 0.7
}

{
  "id": "chat_abc123",
  "object": "chat.completion",
  "model": "claude-sonnet-4.6",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Machine learning is a subset of AI..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 45,
    "completion_tokens": 150,
    "total_tokens": 195
  },
  "cost": 0.002925
}

curl -X POST https://kunya.ai/api/v1/chat/completions \
  -H "Authorization: Bearer kunya_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Hello!"}],
    "model": "claude-sonnet-4.6",
    "stream": false
  }'

{
  "models": [
    {
      "id": "gpt-5.5",
      "name": "GPT-5.5",
      "provider": "openai",
      "type": "chat",
      "pricing": {
        "input": 0.005,
        "output": 0.015
      },
      "supports_streaming": true,
      "supports_vision": true
    }
  ]
}

{
  "model": "claude-sonnet-4.6",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "What is machine learning?"}
  ],
  "stream": false
}

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [{"type": "text", "text": "Machine learning is..."}],
  "model": "claude-sonnet-4.6",
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 12, "output_tokens": 150}
}

import anthropic

client = anthropic.Anthropic(
    api_key="kunya_YOUR_API_KEY",
    base_url="https://kunya.ai/api"
)

message = client.messages.create(
    model="gemini-2.5-flash",  # Any Kunya model
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content[0].text)

curl -X POST https://kunya.ai/api/v1/messages \
  -H "x-api-key: kunya_YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

curl -X POST https://kunya.ai/api/v1/messages/count_tokens \
  -H "x-api-key: kunya_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4.6", "messages": [{"role": "user", "content": "Hello"}]}'

GET /api/v1/conversations?limit=50&offset=0

{
  "data": [
    {
      "id": "conv_abc123",
      "title": "Machine Learning Discussion",
      "model": "claude-sonnet-4.6",
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T11:45:00Z"
    }
  ]
}

// Request
{
  "title": "My New Conversation",
  "model": "claude-sonnet-4.6"
}

// Response (201)
{
  "id": "conv_xyz789",
  "title": "My New Conversation",
  "model": "claude-sonnet-4.6",
  "created_at": "2025-01-15T12:00:00Z"
}

{
  "data": [
    {
      "id": "msg_001",
      "role": "user",
      "content": "What is machine learning?",
      "model": null,
      "tokens": 6,
      "created_at": "2025-01-15T10:30:00Z"
    },
    {
      "id": "msg_002",
      "role": "assistant",
      "content": "Machine learning is a subset of AI...",
      "model": "claude-sonnet-4.6",
      "tokens": 150,
      "created_at": "2025-01-15T10:30:05Z"
    }
  ],
  "conversation_id": "conv_abc123"
}

{
  "data": [
    {
      "id": "mem_abc123",
      "content": "User prefers concise responses",
      "category": "preferences",
      "source": "conversation",
      "created_at": "2025-01-15T10:00:00Z"
    }
  ]
}

// Request
{
  "content": "User works in fintech and prefers Python",
  "category": "context"
}

// Response (201)
{
  "id": "mem_xyz789",
  "content": "User works in fintech and prefers Python",
  "category": "context",
  "created_at": "2025-01-15T12:00:00Z"
}

{
  "data": [
    {
      "id": "agent_abc123",
      "name": "Research Assistant",
      "description": "Autonomous research agent",
      "type": "custom",
      "status": "active",
      "is_active": true,
      "config": { ... },
      "stats": { ... },
      "created_at": "2025-01-10T09:00:00Z"
    }
  ]
}

// Request
{
  "name": "Customer Support Bot",
  "description": "Handles tier-1 customer inquiries",
  "type": "support",
  "config": {
    "model": "claude-sonnet-4.6",
    "systemPrompt": "You are a helpful customer support agent...",
    "temperature": 0.5,
    "maxTokens": 2048,
    "memoryEnabled": true
  }
}

// Response (201)
{
  "data": {
    "id": "agent_xyz789",
    "name": "Customer Support Bot",
    "description": "Handles tier-1 customer inquiries",
    "type": "support",
    "status": "active",
    "created_at": "2025-01-15T12:00:00Z"
  },
  "message": "Agent created"
}

// Request
{
  "name": "Updated Agent Name",
  "config": {
    "temperature": 0.3,
    "enabledTools": ["web_search", "calculator"]
  }
}

// Response
{
  "data": {
    "id": "agent_xyz789",
    "name": "Updated Agent Name",
    "status": "active",
    "updated_at": "2025-01-15T14:00:00Z"
  },
  "message": "Agent updated"
}

{
  "objective": "Write an SEO blog post about sustainable fashion trends",
  "instructions": "Use voice profile 'Brand Voice', target keyword 'sustainable fashion 2026', save to blog drafts",
  "type": "autonomous"
}

{
  "data": {
    "id": "task_abc123",
    "agent_id": "agent_xyz789",
    "status": "running",
    "objective": "Write an SEO blog post about sustainable fashion trends",
    "created_at": "2026-02-20T12:00:00Z"
  }
}

{
  "data": {
    "id": "task_abc123",
    "status": "completed",
    "objective": "Write an SEO blog post about sustainable fashion trends",
    "progress_percentage": 100,
    "deliverable": {
      "type": "blog_post",
      "content": "# Sustainable Fashion Trends in 2026\n\nThe fashion industry...",
      "wordCount": 2100,
      "format": "markdown"
    },
    "steps": [
      { "type": "tool_call", "toolName": "writer_load_voice_profile", "status": "completed" },
      { "type": "tool_call", "toolName": "web_search", "status": "completed" },
      { "type": "tool_call", "toolName": "writer_generate_article", "status": "completed" },
      { "type": "tool_call", "toolName": "writer_save_to_blog_drafts", "status": "completed" }
    ],
    "tokens": { "input": 8500, "output": 4200, "total": 12700 },
    "cost": 0.038,
    "timing": {
      "started_at": "2026-02-20T12:00:01Z",
      "completed_at": "2026-02-20T12:01:45Z",
      "duration_seconds": 104
    }
  }
}

{
  "message": "Write a LinkedIn post about our new Portuguese VoIP numbers",
  "conversation_id": "conv_abc123"
}

// Request
{
  "approved": true,
  "feedback": "Looks great, publish it"
}

// Response
{
  "data": { "status": "running", "message": "Task resumed" }
}

// Response
{
  "data": { "status": "cancelled", "message": "Task cancelled" }
}

{
  "objective": "Write 2 LinkedIn posts about remote work productivity",
  "instructions": "Use my default voice profile. Hook-driven format, include CTA. Professional but conversational tone."
}

{
  "objective": "Research the top 10 VoIP providers for Portuguese numbers and write an SEO-optimized blog post",
  "instructions": "Include our service (Kunya) as one of the providers. Target keyword: 'portugal voip number'. Use voice profile 'Brand Voice'. Save to blog drafts. Target 2000+ words. Generate a featured image."
}

{
  "objective": "Translate our latest blog post about VoIP providers into Portuguese and Spanish",
  "instructions": "Adapt cultural references for each market. Preserve SEO structure. Save translations to content library."
}

{
  "prompt": "Write a blog intro about sustainable fashion",
  "profile_id": "profile_xyz789",
  "context": "blog",
  "length": "medium",
  "model": "claude-sonnet-4.6"
}

{
  "content": "In a world where fast fashion dominates...",
  "profile_used": "profile_xyz789",
  "profile_name": "Brand Voice",
  "context": "blog",
  "model": "claude-sonnet-4.6",
  "tokens": 450,
  "cost": 0.00675
}

// Request
{
  "text": "Our product is really good and you should buy it",
  "tone": "professional",
  "style": "persuasive",
  "instructions": "Make it more compelling for enterprise buyers"
}

// Response
{
  "original": "Our product is really good and you should buy it",
  "rewritten": "Our enterprise solution delivers measurable ROI...",
  "tone": "professional",
  "style": "persuasive",
  "cost": "0.00045"
}

{
  "profiles": [
    {
      "id": "profile_xyz789",
      "name": "Brand Voice",
      "description": "Professional yet friendly tone",
      "profile_type": "author",
      "sample_count": 15,
      "word_count": 25000,
      "is_ready": true
    }
  ]
}

{
  "name": "Technical Writer",
  "description": "Clear, precise technical documentation",
  "profile_type": "brand",
  "settings": {
    "formality": 0.8,
    "verbosity": 0.6,
    "technicality": 0.9,
    "warmth": 0.3,
    "confidence": 0.8
  }
}

// GET /api/v1/writing/documents?limit=50&offset=0&folder_id=folder_abc

{
  "data": [
    {
      "id": "doc_abc123",
      "title": "Q1 Marketing Plan",
      "content": "# Marketing Strategy...",
      "folder_id": "folder_abc",
      "word_count": 2500,
      "created_at": "2025-01-10T09:00:00Z",
      "updated_at": "2025-01-15T14:30:00Z"
    }
  ]
}

// Request
{
  "title": "Product Launch Brief",
  "content": "## Overview
Our new product...",
  "folder_id": "folder_abc"
}

// Response (201)
{
  "id": "doc_xyz789",
  "title": "Product Launch Brief",
  "created_at": "2025-01-15T12:00:00Z"
}

// Request
{
  "title": "Updated Title",
  "content": "## Updated Content...",
  "folder_id": "folder_new"
}

// Response
{ "success": true }

// Request
{
  "title": "Blog Post: AI in Healthcare",
  "description": "Long-form article about AI applications in healthcare",
  "profile_id": "profile_xyz789",
  "settings": {
    "model": "claude-sonnet-4.6",
    "target_word_count": 3000,
    "content_type": "blog_post",
    "temperature": 0.7
  }
}

// Response (201)
{
  "id": "session_abc123",
  "title": "Blog Post: AI in Healthcare",
  "status": "active",
  "word_count": 0,
  "created_at": "2025-01-15T12:00:00Z"
}

{
  "id": "session_abc123",
  "title": "Blog Post: AI in Healthcare",
  "content": "## Introduction
AI is transforming healthcare...",
  "outline": [...],
  "settings": { "model": "claude-sonnet-4.6", "target_word_count": 3000 },
  "generation_history": [...],
  "voice_profile_id": "profile_xyz789",
  "word_count": 1250,
  "paragraph_count": 8,
  "total_tokens_used": 5400,
  "total_cost": "0.081",
  "status": "active",
  "created_at": "2025-01-15T12:00:00Z"
}

GET /api/v1/writing/sessions?status=active&limit=20&offset=0

{
  "prompt": "A serene mountain landscape at sunset, digital art style",
  "model": "gpt-image-2",
  "size": "1024x1024",
  "quality": "hd",
  "style": "vivid"
}

{
  "prompt": "A serene mountain landscape at sunset --ar 16:9 --style raw",
  "model": "midjourney-v7",
  "midjourney_speed": "fast"
}

{
  "id": "img_abc123",
  "url": "data:image/png;base64,...",
  "model": "gpt-image-2",
  "size": "1024x1024",
  "quality": "hd",
  "revised_prompt": "A serene mountain landscape...",
  "cost": 0.080
}

{
  "id": "img_mj_456",
  "data": [
    { "url": "https://cdn.midjourney.com/...", "index": 0 },
    { "url": "https://cdn.midjourney.com/...", "index": 1 },
    { "url": "https://cdn.midjourney.com/...", "index": 2 },
    { "url": "https://cdn.midjourney.com/...", "index": 3 }
  ],
  "model": "midjourney-v7",
  "prompt": "A serene mountain landscape at sunset --ar 16:9 --style raw",
  "cost": 0.100
}

{
  "prompt": "Make the sky more dramatic with storm clouds",
  "model": "gpt-image-2",
  "reference_images": [
    {
      "url": "data:image/png;base64,...",
      "purpose": "edit"
    }
  ]
}

// Request
{
  "prompts": [
    "A futuristic cityscape at dawn",
    "A cozy cabin in the woods",
    "An underwater coral reef"
  ],
  "model": "gpt-image-2",
  "size": "1024x1024",
  "quality": "standard"
}

// Response
{
  "data": [
    { "prompt": "A futuristic cityscape...", "url": "data:image/png;base64,...", "cost": 0.04 },
    { "prompt": "A cozy cabin...", "url": "data:image/png;base64,...", "cost": 0.04 },
    { "prompt": "An underwater coral reef", "url": "data:image/png;base64,...", "cost": 0.04 }
  ],
  "total": 3,
  "successful": 3,
  "total_cost": 0.12
}

// Request
{
  "action": "parse",
  "task": "Generate with Nano Banana Pro:\n- A sunset over a mountain lake\n\nGenerate with DALL·E 3:\n- A vintage travel poster for Japan",
  "parser_model": "gemini-3.5-flash",
  "reference_images": [
    { "base64": "data:image/png;base64,...", "filename": "style-ref.png" }
  ]
}

// Response
{
  "data": {
    "items": [
      { "id": "item_1", "model": "gemini-3-pro-image", "model_name": "Nano Banana Pro", "prompt": "A sunset over a mountain lake", "estimated_cost": 0.02 },
      { "id": "item_2", "model": "gpt-image-2", "model_name": "DALL·E 3", "prompt": "A vintage travel poster for Japan", "estimated_cost": 0.04 }
    ],
    "total_estimated_cost": 0.06
  }
}

// Request
{
  "action": "execute",
  "items": [{ "id": "item_1", "model": "gemini-3-pro-image", "prompt": "...", "size": "1024x1024", "quality": "auto", "estimated_cost": 0.02 }],
  "reference_images": [{ "base64": "data:image/png;base64,...", "filename": "style-ref.png" }]
}

// SSE Events
event: job_created → { "job_id": "uuid", "total_items": 2 }
event: item_started → { "item_id": "item_1" }
event: item_completed → { "item_id": "item_1", "image_url": "https://...", "cost": 0.02 }
event: item_failed → { "item_id": "item_2", "error": "Provider timeout" }
event: done → { "total": 2, "succeeded": 1, "failed": 1, "total_cost": 0.02 }

{ "action": "cancel", "job_id": "uuid" }

// Request
{
  "prompt": "a cat on a roof",
  "style": "photorealistic"
}

// Response
{
  "original_prompt": "a cat on a roof",
  "enhanced_prompt": "A sleek orange tabby cat perched on terracotta roof tiles at golden hour, soft bokeh background of a Mediterranean village, warm sunlight casting long shadows, photorealistic, 8K detail",
  "cost": "0.00015"
}

{
  "data": [
    {
      "id": "proj_abc",
      "name": "Marketing Assets",
      "description": "Social media and ad images",
      "image_count": 45,
      "created_at": "2025-01-10T09:00:00Z"
    }
  ]
}

{
  "prompt": "A majestic eagle soaring through misty mountains at sunrise, cinematic",
  "model": "kling-2.5-pro",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "1080p"
}

{
  "prompt": "Gentle wind blowing through hair, subtle movement",
  "model": "kling-2.5-pro-i2v",
  "image_url": "data:image/png;base64,...",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}

{
  "created": 1704067200,
  "data": [
    {
      "url": "https://fal.media/files/video_abc123.mp4",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "model": "kling-2.5-pro"
    }
  ],
  "usage": {
    "duration_seconds": 5,
    "cost": 0.375
  }
}

// GET /api/v1/videos/status?id=gen_abc123

{
  "id": "gen_abc123",
  "status": "completed",
  "video_url": "https://fal.media/files/video_abc123.mp4",
  "thumbnail_url": "https://...",
  "prompt": "A majestic eagle soaring...",
  "model": "kling-2.5-pro",
  "created_at": "2025-01-15T12:00:00Z"
}

// Request
{
  "script": "Introducing our revolutionary new fitness app...",
  "product_name": "FitPro AI",
  "target_audience": "Health-conscious millennials",
  "style": "energetic",
  "duration": 30
}

// Response
{
  "id": "ad_abc123",
  "script": "Enhanced script with scene directions...",
  "style": "energetic",
  "duration": 30,
  "cost": "0.025",
  "created_at": "2025-01-15T12:00:00Z"
}

{
  "object": "list",
  "data": [
    {
      "id": "kling-2.5-pro",
      "name": "Kling 2.5 Pro",
      "description": "High-quality video with excellent character consistency",
      "provider": "FAL AI (Kling)",
      "capabilities": {
        "text_to_video": true,
        "image_to_video": false,
        "video_to_video": false
      },
      "supported_resolutions": ["720p", "1080p", "4k"],
      "max_duration": 10,
      "pricing": { "per_second": 0.05 }
    },
    {
      "id": "seedance-2.0-t2v",
      "name": "Seedance 2.0 Text-to-Video",
      "description": "ByteDance Seedance 2.0 — multimodal video with synced audio, lip-sync, up to 15s",
      "provider": "Kunya (Seedance)",
      "capabilities": {
        "text_to_video": true,
        "image_to_video": false,
        "video_to_video": false
      },
      "supported_resolutions": ["480p", "720p"],
      "max_duration": 15,
      "pricing": { "per_second": 0.147 }
    },
    {
      "id": "seedance-1.5-pro",
      "name": "Seedance 1.5 Pro",
      "description": "ByteDance Seedance 1.5 — synchronized audio+video with lip-sync and foley",
      "provider": "Kunya (Seedance)",
      "capabilities": {
        "text_to_video": true,
        "image_to_video": true,
        "video_to_video": false
      },
      "supported_resolutions": ["480p", "720p", "1080p"],
      "max_duration": 12,
      "pricing": { "per_second": 0.08 }
    },
    {
      "id": "evolink-wan2.7-t2v",
      "name": "Wan 2.7 Text-to-Video",
      "description": "Alibaba Wan 2.7 via Kunya — multi-shot narrative, auto BGM/SFX or driving-audio lip-sync, 2-15s",
      "provider": "Kunya (Wan)",
      "capabilities": {
        "text_to_video": true,
        "image_to_video": false,
        "video_to_video": false
      },
      "supported_resolutions": ["720p", "1080p"],
      "min_duration": 2,
      "max_duration": 15,
      "pricing": { "per_second": 0.086 }
    }
  ]
}

{
  "prompt": "A small kitten running under the moonlight",
  "model": "evolink-wan2.7-t2v",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "audio_urls": ["https://example.com/recital.mp3"],
  "negative_prompt": "blurry, low quality",
  "seed": 42,
  "model_params": { "prompt_extend": false }
}

{
  "video_url": "https://www.youtube.com/watch?v=Wlf1T5nrO50",
  "prompt": "Describe the hook in the first 5 seconds, the narration tone, and the pacing (cuts per 30s).",
  "response_format": "json",
  "json_schema_hint": "{ hookStyle, narrationTone, cutsPer30s, overallSentiment }",
  "model": "gemini-3.5-flash",
  "duration_seconds_hint": 480
}

{
  "analysis": {
    "hookStyle": "Direct contrarian claim with on-screen counter-thesis",
    "narrationTone": "Casual, fast, mild sarcasm",
    "cutsPer30s": 14,
    "overallSentiment": "skeptical-positive"
  },
  "format": "json",
  "model": "gemini-3.5-flash",
  "videoUrl": "https://www.youtube.com/watch?v=Wlf1T5nrO50",
  "isYouTube": true,
  "tokens": { "input": 4123, "output": 312 }
}

curl -X POST https://api.kunya.ai/api/v1/videos/analyze \
  -H "Authorization: Bearer kunya_..." \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=Wlf1T5nrO50",
    "prompt": "What is this video about? List the 3 main claims.",
    "response_format": "json",
    "json_schema_hint": "{ summary, claims: string[] }"
  }'

{
  "name": "My Video Project",
  "sources": [
    { "id": "src_1", "type": "video", "url": "https://...", "name": "Intro.mp4", "duration": 15.5 },
    { "id": "src_2", "type": "audio", "url": "https://...", "name": "BGMusic.mp3", "duration": 120 },
    { "id": "src_3", "type": "image", "url": "https://...", "name": "Logo.png" }
  ],
  "tracks": [
    {
      "id": "track_v1", "type": "video", "volume": 1,
      "clips": [
        {
          "id": "clip_1", "sourceId": "src_1",
          "startTime": 0, "duration": 10,
          "sourceIn": 0, "sourceOut": 10,
          "effects": [
            { "type": "color_grade", "params": { "brightness": 0.05, "contrast": 1.2, "saturation": 0.9 } }
          ],
          "transition": null
        }
      ]
    },
    {
      "id": "track_a1", "type": "audio", "volume": 0.5,
      "clips": [
        { "id": "clip_a1", "sourceId": "src_2", "startTime": 0, "duration": 10, "sourceIn": 0, "sourceOut": 10 }
      ]
    }
  ],
  "outputSettings": { "format": "mp4", "resolution": "1080p", "fps": 30, "codec": "h264" }
}

{
  "success": true,
  "project": {
    "id": "proj_abc123",
    "name": "My Video Project",
    "status": "draft",
    "created_at": "2025-01-15T12:00:00Z"
  }
}

{
  "success": true,
  "projects": [
    { "id": "proj_abc123", "name": "My Video Project", "status": "draft", "created_at": "..." },
    { "id": "proj_def456", "name": "Product Demo", "status": "completed", "outputUrl": "https://..." }
  ]
}

{
  "projectId": "proj_abc123",
  "type": "render",
  "outputSettings": { "format": "mp4", "resolution": "1080p", "fps": 30, "codec": "h264" }
}

{
  "success": true,
  "jobId": "job_xyz789",
  "status": "queued"
}

{
  "success": true,
  "job": { "id": "job_xyz789", "status": "processing", "progress": 65, "outputUrl": null }
}

{
  "success": true,
  "job": { "id": "job_xyz789", "status": "completed", "progress": 100, "outputUrl": "https://r2.example.com/output.mp4" }
}

{
  "message": "Add dissolve transitions between all clips, apply cinematic color grading, and add a title at the start",
  "model": "claude-sonnet-4.6",
  "sources": [
    { "id": "src_1", "type": "video", "url": "https://...", "name": "Footage.mp4", "duration": 30 }
  ],
  "tracks": [
    { "id": "track_v", "type": "video", "clips": [
      { "id": "clip_1", "sourceId": "src_1", "startTime": 0, "duration": 15, "sourceIn": 0, "sourceOut": 15 },
      { "id": "clip_2", "sourceId": "src_1", "startTime": 15, "duration": 15, "sourceIn": 15, "sourceOut": 30 }
    ]}
  ]
}

{
  "success": true,
  "message": "Added dissolve transitions (0.5s), applied cinematic color grade, and added 'My Title' text at 0-3s.",
  "tracks": [
    { "id": "track_v", "type": "video", "clips": [
      { "id": "clip_1", "sourceId": "src_1", "startTime": 0, "duration": 15, "sourceIn": 0, "sourceOut": 15,
        "effects": [{ "type": "color_grade", "params": { "brightness": 0.05, "contrast": 1.3, "saturation": 0.85, "temperature": 0.1 } }]
      },
      { "id": "clip_2", "sourceId": "src_1", "startTime": 15, "duration": 15, "sourceIn": 15, "sourceOut": 30,
        "transition": { "type": "dissolve", "duration": 0.5 },
        "effects": [{ "type": "color_grade", "params": { "brightness": 0.05, "contrast": 1.3, "saturation": 0.85, "temperature": 0.1 } }]
      }
    ]},
    { "id": "track_t", "type": "text", "clips": [
      { "id": "clip_t1", "sourceId": "", "startTime": 0, "duration": 3, "sourceIn": 0, "sourceOut": 3, "text": "My Title", "style": { "fontSize": 72, "fontColor": "white", "fontWeight": "bold" } }
    ]}
  ]
}

{
  "text": "Hello, welcome to our platform!",
  "provider": "elevenlabs",
  "voice_id": "21m00Tcm4TlvDq8ikWAM",
  "settings": {
    "stability": 0.5,
    "similarity_boost": 0.75
  }
}

{
  "id": "audio_abc123",
  "audio_url": "data:audio/mpeg;base64,...",
  "provider": "elevenlabs",
  "voice_id": "21m00Tcm4TlvDq8ikWAM",
  "voice_name": "Rachel",
  "duration": 3,
  "cost": 0.0012
}

curl -X POST https://kunya.ai/api/v1/audio/transcriptions \
  -H "Authorization: Bearer kunya_YOUR_API_KEY" \
  -F "[email protected]" \
  -F "language=en" \
  -F "response_format=json"

{
  "transcription": {
    "text": "Hello, this is a test recording..."
  },
  "model": "whisper-1",
  "language": "en",
  "duration_seconds": 45,
  "cost": 0.0045
}

curl -X POST https://kunya.ai/api/v1/audio/meeting-notes \
  -H "Authorization: Bearer kunya_YOUR_API_KEY" \
  -F "[email protected]"

{
  "transcription": "Full transcript of the meeting...",
  "duration": 1800,
  "notes": {
    "summary": "Team discussed Q1 roadmap priorities...",
    "key_points": ["Agreed on new feature timeline", "Budget approved"],
    "action_items": [
      { "owner": "Alice", "task": "Draft PRD by Friday" },
      { "owner": "Bob", "task": "Set up staging environment" }
    ]
  },
  "cost": "0.235"
}

{
  "prompt": "A cheerful summer pop song about road trips and freedom",
  "model": "suno-v5",
  "duration": 60,
  "style": "pop, electronic, upbeat"
}

{
  "prompt": "[Verse]\nDriving down the highway, windows down\n[Chorus]\nSummer dreams, summer nights",
  "model": "suno-v4.5",
  "title": "Summer Dreams",
  "style": "pop, electronic, upbeat, female vocals",
  "instrumental": false,
  "vocal_gender": "f",
  "negative_tags": "heavy metal, screaming",
  "style_weight": 0.7
}

{
  "id": "music_abc123",
  "model": "suno-v5",
  "audio_url": "https://media.example.com/music_abc123.mp3",
  "duration": 91,
  "cost": "0.10",
  "created_at": "2025-01-15T12:00:00Z"
}

// Request
{
  "action": "parse",
  "task": "Generate 3 tracks:\n- An upbeat electronic track with synths, 60s (CassetteAI)\n- A cinematic orchestral piece, 90s (Lyria)\n- A pop song about summer with vocals, 60s (Suno V5)",
  "parser_model": "gemini-3.5-flash"
}

// Response
{
  "data": {
    "items": [
      { "id": "item_1", "model": "cassetteai-music", "model_name": "CassetteAI Music", "prompt": "Upbeat electronic track with driving synths", "duration": 60, "estimated_cost": 0.02 },
      { "id": "item_2", "model": "lyria-realtime", "model_name": "Lyria RealTime", "prompt": "Cinematic orchestral piece with strings", "duration": 90, "estimated_cost": 0.036 },
      { "id": "item_3", "model": "suno-v5", "model_name": "Suno V5", "prompt": "Pop song about summer love", "duration": 60, "style": "upbeat", "lyrics": "[Verse]\nSunshine on my face...", "estimated_cost": 0.06 }
    ],
    "total_estimated_cost": 0.116
  }
}

// Request
{
  "action": "execute",
  "items": [{ "id": "item_1", "model": "cassetteai-music", "prompt": "...", "duration": 60, "estimated_cost": 0.02 }]
}

// SSE Events
event: job_created → { "job_id": "uuid", "total_items": 3 }
event: item_started → { "item_id": "item_1" }
event: item_completed → { "item_id": "item_1", "audio_url": "https://...", "cost": 0.02, "duration": 62 }
event: item_failed → { "item_id": "item_2", "error": "Provider timeout" }
event: done → { "total": 3, "succeeded": 2, "failed": 1, "total_cost": 0.08 }

{ "action": "cancel", "job_id": "uuid" }

// Request
{
  "script": [
    { "speaker": "host", "text": "Welcome to the show! Today we're discussing AI." },
    { "speaker": "guest", "text": "Thanks for having me. AI is transforming everything." },
    { "speaker": "host", "text": "Let's dive into the key trends." }
  ],
  "speakers": [
    { "id": "host", "name": "Sarah", "voice_id": "21m00Tcm4TlvDq8ikWAM" },
    { "id": "guest", "name": "Dr. Chen", "voice_id": "EXAVITQu4vr4xnSDxMaL" }
  ]
}

// Response
{
  "id": "podcast_abc123",
  "segments": [
    { "speaker": "host", "audio_url": "data:audio/mpeg;base64,...", "text": "Welcome to the show!..." },
    { "speaker": "guest", "audio_url": "data:audio/mpeg;base64,...", "text": "Thanks for having me..." },
    { "speaker": "host", "audio_url": "data:audio/mpeg;base64,...", "text": "Let's dive into..." }
  ],
  "total_segments": 3,
  "cost": "0.0156",
  "created_at": "2025-01-15T12:00:00Z"
}

{
  "object": "list",
  "data": [
    {
      "id": "alloy",
      "name": "Alloy",
      "description": "Neutral and balanced",
      "provider": "openai",
      "category": "default"
    },
    {
      "id": "voice_abc123",
      "name": "My Brand Voice",
      "description": "Custom cloned voice",
      "provider": "elevenlabs",
      "category": "cloned",
      "preview_url": "https://..."
    }
  ]
}

curl -X POST https://kunya.ai/api/v1/audio/voices \
  -H "Authorization: Bearer kunya_YOUR_API_KEY" \
  -F "name=My Brand Voice" \
  -F "description=Professional narrator voice" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]"

{
  "id": "voice_abc123xyz",
  "name": "My Brand Voice",
  "description": "Professional narrator voice",
  "provider": "elevenlabs",
  "created": 1704067200
}

// Request
{
  "name": "Support Agent",
  "description": "Handles customer support calls",
  "type": "support",
  "voice": {
    "provider": "elevenlabs",
    "voice_id": "21m00Tcm4TlvDq8ikWAM"
  },
  "model": "claude-sonnet-4.6",
  "system_prompt": "You are a helpful customer support agent...",
  "greeting": "Hello! How can I help you today?",
  "language": "en",
  "max_call_duration_minutes": 30
}

// Response (201)
{
  "data": {
    "id": "vagent_abc123",
    "name": "Support Agent",
    "type": "support",
    "is_active": true,
    "created_at": "2025-01-15T12:00:00Z"
  },
  "message": "Voice agent created"
}

// GET /api/v1/voice/agents?type=support&active=true

{
  "data": [
    {
      "id": "vagent_abc123",
      "name": "Support Agent",
      "type": "support",
      "voice": { "provider": "elevenlabs", "voice_id": "..." },
      "model": "claude-sonnet-4.6",
      "phone_number": "+1234567890",
      "is_active": true,
      "stats": {
        "total_calls": 150,
        "avg_call_duration": 180,
        "avg_satisfaction": 4.5
      },
      "created_at": "2025-01-10T09:00:00Z"
    }
  ]
}

{
  "data": {
    "id": "vagent_abc123",
    "name": "Support Agent",
    "type": "support",
    "voice": { "provider": "elevenlabs", "voice_id": "..." },
    "model": "claude-sonnet-4.6",
    "temperature": 0.7,
    "system_prompt": "You are a helpful...",
    "greeting": "Hello! How can I help?",
    "behavior_rules": [...],
    "forbidden_topics": [...],
    "is_active": true,
    "stats": { "total_calls": 150 },
    "recent_calls": [...],
    "created_at": "2025-01-10T09:00:00Z"
  }
}

// GET /api/v1/content?limit=50&offset=0&content_type=article&search=AI

{
  "data": [
    {
      "id": "cnt_abc123",
      "title": "The Future of AI in Healthcare",
      "description": "A comprehensive overview...",
      "content_type": "article",
      "url": "https://example.com/ai-healthcare",
      "summary": "AI is revolutionizing healthcare...",
      "is_favorite": true,
      "collection_id": "col_xyz",
      "created_at": "2025-01-15T10:00:00Z"
    }
  ],
  "total": 42,
  "limit": 50,
  "offset": 0
}

// Request
{
  "title": "Great Article on AI",
  "url": "https://example.com/ai-article",
  "content_type": "article",
  "collection_id": "col_xyz"
}

// Response (201)
{
  "id": "cnt_xyz789",
  "title": "Great Article on AI",
  "content_type": "article",
  "created_at": "2025-01-15T12:00:00Z"
}

// Request
{
  "url": "https://example.com/long-article",
  "max_length": 300
}

// Response
{
  "summary": "This article discusses the key trends in AI...",
  "cost": "0.0025"
}

{
  "data": [
    {
      "id": "col_xyz",
      "name": "AI Research",
      "description": "Curated AI research papers and articles",
      "color": "#3b82f6",
      "icon": "brain",
      "created_at": "2025-01-01T00:00:00Z"
    }
  ]
}

// Request
{
  "name": "Product Research",
  "description": "Competitor analysis and market research",
  "color": "#10b981",
  "icon": "search"
}

// Response (201)
{
  "id": "col_new123",
  "name": "Product Research",
  "created_at": "2025-01-15T12:00:00Z"
}

// Request
{
  "query": "latest developments in quantum computing 2025",
  "max_results": 5,
  "search_depth": "basic"
}

// Response
{
  "query": "latest developments in quantum computing 2025",
  "provider": "brave",
  "results": [
    {
      "title": "Quantum Computing Breakthroughs in 2025",
      "url": "https://example.com/quantum-2025",
      "content": "Researchers have achieved a major milestone..."
    },
    {
      "title": "IBM's New Quantum Processor",
      "url": "https://example.com/ibm-quantum",
      "content": "IBM unveiled its latest quantum processor..."
    }
  ],
  "cost": "0.001"
}

curl -X POST https://kunya.ai/api/v1/files/process \
  -H "Authorization: Bearer kunya_YOUR_API_KEY" \
  -F "[email protected]" \
  -F "action=extract_text"

{
  "filename": "document.pdf",
  "size": 245000,
  "type": "application/pdf",
  "action": "extract_text",
  "text": "Extracted text content from the PDF...",
  "cost": "0.001"
}

curl -X POST https://kunya.ai/api/v1/files/convert \
  -H "Authorization: Bearer kunya_YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=xlsx"

curl -X GET "https://api.kunya.app/v1/workspaces/pages?type=document&limit=20" \
  -H "Authorization: Bearer kunya_xxx"

curl -X POST "https://api.kunya.app/v1/workspaces/pages" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{"title": "Project Plan", "type": "document", "emoji": "📋"}'

curl -X POST "https://api.kunya.app/v1/workspaces/databases/db_xxx/rows" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{"cells": {"col_title": "New Task", "col_status": "in_progress", "col_priority": 3}}'

curl -X GET "https://api.kunya.app/v1/workspaces/search?q=project+plan&limit=10" \
  -H "Authorization: Bearer kunya_xxx"

curl -X GET "https://api.kunya.app/v1/workspaces/pages/PAGE_ID/whiteboard" \
  -H "Authorization: Bearer kunya_xxx"

curl -X PUT "https://api.kunya.app/v1/workspaces/pages/PAGE_ID/whiteboard" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{"shapes": [{"type": "rectangle", "x": 100, "y": 100, "width": 200, "height": 150}]}'

curl -X POST "https://api.kunya.app/v1/workspaces/pages/PAGE_ID/whiteboard/shapes" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{"shapes": [
    {"type": "rectangle", "x": 100, "y": 100, "width": 200, "height": 100, "text": "Step 1", "fill": "#bfdbfe"},
    {"type": "rectangle", "x": 400, "y": 100, "width": 200, "height": 100, "text": "Step 2", "fill": "#bbf7d0"},
    {"type": "connector", "start_shape_id": "SHAPE_1_ID", "end_shape_id": "SHAPE_2_ID"}
  ]}'

curl -X PUT "https://api.kunya.app/v1/workspaces/pages/PAGE_ID/whiteboard/shapes/SHAPE_ID" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{"text": "Updated label", "fill": "#fecaca"}'

curl -X DELETE "https://api.kunya.app/v1/workspaces/pages/PAGE_ID/whiteboard/shapes/SHAPE_ID" \
  -H "Authorization: Bearer kunya_xxx"

# Get content as JSON
curl "https://api.kunya.app/v1/workspaces/pages/PAGE_ID/content" \
  -H "Authorization: Bearer kunya_xxx"

# Get content as Markdown
curl "https://api.kunya.app/v1/workspaces/pages/PAGE_ID/content?format=markdown" \
  -H "Authorization: Bearer kunya_xxx"

curl -X PATCH "https://api.kunya.app/v1/workspaces/databases/DB_ID/columns" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "operations": [
      { "op": "add", "column": { "name": "Status", "type": "select", "options": [{"label":"To Do"},{"label":"Done"}] } },
      { "op": "add", "column": { "name": "Due Date", "type": "date" } },
      { "op": "update", "column_id": "COL_ID", "updates": { "name": "Renamed Column", "width": 250 } },
      { "op": "delete", "column_id": "OLD_COL_ID" }
    ]
  }'

curl "https://api.kunya.app/v1/workspaces/spaces/SPACE_ID/members" \
  -H "Authorization: Bearer kunya_xxx"

curl -X POST "https://api.kunya.app/v1/workspaces/spaces/SPACE_ID/members" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "user_id": "USER_UUID", "role": "editor" }'

curl -X DELETE "https://api.kunya.app/v1/workspaces/spaces/SPACE_ID/members?user_id=USER_UUID" \
  -H "Authorization: Bearer kunya_xxx"

curl -X POST "https://api.kunya.app/v1/workspaces/pages/bulk" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "pages": [
      { "_ref": "project", "title": "Q2 Project", "space_id": "SPACE_ID" },
      { "title": "Requirements", "parent_ref": "project" },
      { "title": "Sprint Board", "parent_ref": "project", "type": "database" },
      { "title": "Architecture", "parent_ref": "project", "type": "whiteboard" }
    ]
  }'

# Summarize a page
curl -X POST "https://api.kunya.app/v1/workspaces/pages/PAGE_ID/ai" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "operation": "ai_summarize" }'

# Translate content to Spanish
curl -X POST "https://api.kunya.app/v1/workspaces/pages/PAGE_ID/ai" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "operation": "ai_translate", "target_language": "Spanish" }'

# Generate content from an instruction
curl -X POST "https://api.kunya.app/v1/workspaces/pages/PAGE_ID/ai" \
  -H "Authorization: Bearer kunya_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "operation": "ai_write", "instruction": "Write a project kickoff agenda" }'

{
  "workspace": {
    "id": "ws_abc123",
    "name": "My Workspace"
  },
  "members": [
    {
      "id": "member_001",
      "user_id": "user_abc",
      "role": "owner",
      "name": "Alice Smith",
      "email": "[email protected]",
      "joined_at": "2025-01-01T00:00:00Z"
    }
  ],
  "total_members": 5
}

// Request
{
  "email": "[email protected]",
  "role": "user"
}

// Response (201)
{
  "id": "member_002",
  "user_id": "user_bob",
  "email": "[email protected]",
  "role": "user",
  "invited_at": "2025-01-15T12:00:00Z"
}

// Request
{ "role": "team_admin" }

// Response
{ "success": true }

curl -X POST https://kunya.ai/api/v1/web/fetch \
  -H "Authorization: Bearer kunya_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

{
  "url": "https://example.com/",
  "statusCode": 200,
  "title": "Example Domain",
  "description": "",
  "markdown": "# Example Domain\n\nThis domain is for use in illustrative examples...",
  "text": "Example Domain This domain is for use in illustrative examples...",
  "links": [
    { "href": "https://www.iana.org/domains/example", "text": "More information..." }
  ],
  "contentType": "text/html; charset=UTF-8",
  "source": "http",
  "fetchedAt": "2026-04-16T12:34:56.000Z"
}

{
  "url": "https://example.com/",
  "provider": "playwright",
  "captured_at": "2026-04-16T12:34:56.000Z",
  "base64": "iVBORw0KGgoAAAANSUhEUgAA...",
  "mime_type": "image/png"
}

{
  "url": "https://example.com/",
  "provider": "screenshotone",
  "captured_at": "2026-04-16T12:34:56.000Z",
  "image_url": "https://api.screenshotone.com/take?access_key=...&url=..."
}

{
  "url": "https://example.com/whitepaper.pdf",
  "numPages": 12,
  "title": "Kunya Platform Whitepaper",
  "text": "Introduction\nKunya is an AI platform...",
  "pages": [
    { "pageNumber": 1, "text": "Introduction..." },
    { "pageNumber": 2, "text": "Architecture..." }
  ],
  "fetchedAt": "2026-04-16T12:34:56.000Z"
}

{
  "url": "https://example.com/sitemap.xml",
  "totalUrls": 1248,
  "subSitemaps": ["https://example.com/sitemap-posts.xml", "https://example.com/sitemap-pages.xml"],
  "urls": [
    { "loc": "https://example.com/", "lastmod": "2025-12-01", "priority": 1.0 },
    { "loc": "https://example.com/pricing", "lastmod": "2025-11-22", "priority": 0.8 }
  ],
  "fetchedAt": "2026-04-16T12:34:56.000Z"
}

{
  "url": "https://www.google.com/search",
  "robotsUrl": "https://www.google.com/robots.txt",
  "allowed": false,
  "matchedRule": { "type": "disallow", "pattern": "/search", "userAgent": "*" },
  "crawlDelay": null,
  "sitemaps": ["https://www.google.com/sitemap.xml"],
  "fetchedAt": "2026-04-16T12:34:56.000Z"
}

{
  "url": "https://news.ycombinator.com/rss",
  "feedTitle": "Hacker News",
  "feedDescription": "Links for the intellectually curious, ranked by readers.",
  "items": [
    {
      "title": "Show HN: A tiny OS in 300 lines of Rust",
      "link": "https://example.com/tiny-os",
      "pubDate": "Wed, 16 Apr 2026 09:12:34 +0000",
      "author": "user123",
      "summary": "I built a minimal Unix-like OS...",
      "content": null
    }
  ],
  "fetchedAt": "2026-04-16T12:34:56.000Z"
}

// Request
{
  "text": "Hello, how are you today?",
  "target_language": "Spanish",
  "source_language": "English"
}

// Response
{
  "translated_text": "Hola, ¿cómo estás hoy?",
  "source_language": "English",
  "target_language": "Spanish",
  "cost": 0.00015
}

// Request
{
  "text": "We need to get this done ASAP",
  "style": "professional"
}

// Response
{
  "rewritten_text": "We should prioritize completing this task at your earliest convenience.",
  "style": "professional",
  "cost": 0.00012
}

// Available styles:
// professional, casual, formal, creative, concise, 
// elaborate, seo, email, social

// GET /api/v1/analytics?period=30d
// Available periods: 7d, 30d, 90d

{
  "period": "30d",
  "total_cost": 45.50,
  "usage_by_feature": [
    {
      "feature": "chat",
      "cost": 28.00,
      "requests": 800,
      "input_tokens": 250000,
      "output_tokens": 100000
    },
    {
      "feature": "images",
      "cost": 12.00,
      "requests": 150,
      "input_tokens": 0,
      "output_tokens": 0
    }
  ],
  "generations_by_type": [
    { "type": "image", "count": 150 },
    { "type": "audio", "count": 45 },
    { "type": "video", "count": 12 }
  ]
}

{
  "billing": {
    "plan": "professional",
    "credits_total": 100.00,
    "credits_used": 45.50,
    "credits_remaining": 54.50,
    "overage_enabled": true,
    "period_start": "2025-01-01T00:00:00Z",
    "period_end": "2025-02-01T00:00:00Z"
  },
  "current_period": {
    "total_requests": 1250,
    "total_tokens": 458000,
    "total_cost": 45.50,
    "by_feature": [
      { "feature": "chat", "requests": 800, "tokens": 350000, "cost": 28.00 },
      { "feature": "writing", "requests": 300, "tokens": 100000, "cost": 12.50 },
      { "feature": "images", "requests": 150, "tokens": 0, "cost": 5.00 }
    ]
  },
  "daily_usage": [
    { "date": "2025-01-15", "requests": 45, "cost": 1.25 }
  ]
}

{
  "name": "Alice Smith",
  "email": "[email protected]",
  "plan": "professional"
}

// Request
{ "name": "Alice Johnson" }

// Response
{ "success": true }

{
  "keys": [
    {
      "id": "key_abc123",
      "name": "Production Key",
      "key_prefix": "kunya_ab12...",
      "is_active": true,
      "last_used_at": "2025-01-15T10:30:00Z",
      "created_at": "2025-01-01T00:00:00Z"
    }
  ]
}

// Request
{ "name": "My New Key" }

// Response
{
  "id": "key_xyz789",
  "key": "kunya_aBcDeFgH...",  // Only shown once!
  "name": "My New Key",
  "created_at": "2025-01-15T12:00:00Z",
  "message": "Save this key securely. It will not be shown again."
}

curl -X DELETE https://kunya.ai/api/v1/keys/key_xyz789 \
  -H "Cookie: session=..."

{
  "subject": "Cannot access my account",
  "description": "I've been locked out since yesterday...",
  "requester_email": "[email protected]",
  "requester_name": "Jane Smith",
  "priority": "high",
  "channel": "email",
  "tags": ["login", "urgent"]
}

curl -H "Authorization: Bearer kunya_YOUR_KEY" \
  "https://kunya.ai/api/v1/support/tickets?status=open&priority=high&q=login&limit=50"

curl -H "Authorization: Bearer kunya_YOUR_KEY" \
  "https://kunya.ai/api/v1/support/tickets/TICKET_ID"

{
  "status": "pending",
  "priority": "urgent",
  "assigned_user_id": "user_uuid",
  "tags": ["escalated"]
}

{ "source_ticket_id": "ticket_uuid_to_merge" }

{
  "ticket_ids": ["id1", "id2", "id3"],
  "updates": { "status": "solved", "tags": ["resolved"] }
}

{
  "tickets": [
    {
      "external_id": "zen_12345",
      "subject": "Login not working",
      "requester_email": "[email protected]",
      "requester_name": "Jane Doe",
      "status": "solved",
      "priority": "high",
      "channel": "email",
      "tags": ["login"],
      "created_at": "2025-06-15T10:30:00Z",
      "comments": [
        { "author_type": "customer", "body": "I can't log in.", "created_at": "2025-06-15T10:30:00Z" },
        { "author_type": "agent", "author_name": "Support", "body": "Fixed!", "created_at": "2025-06-15T14:00:00Z" }
      ]
    }
  ],
  "skip_duplicates": true
}

{
  "body": "Thanks for reaching out. I've looked into this...",
  "is_public": true,
  "author_type": "user",
  "author_name": "Support Agent"
}

{ "score": 5, "comment": "Great support!", "customer_id": "customer_uuid" }

{
  "subject": "Need input from engineering",
  "channel_type": "internal",
  "initial_message": "Can you check if this is a known bug?"
}

{ "user_id": "user_uuid" }

{
  "email": "[email protected]",
  "name": "John Customer",
  "company": "Acme Corp",
  "organization_id": "org_uuid",
  "tags": ["vip"],
  "custom_fields": { "plan": "enterprise" }
}

{
  "name": "Acme Corp",
  "domains": ["acme.com", "acme.io"],
  "shared_tickets": true,
  "tags": ["enterprise"]
}

{ "name": "Tier 1 Support", "description": "First-line support team" }

{ "user_id": "user_uuid", "role": "member" }

{ "name": "billing", "color": "#FF5733" }

{
  "name": "Close and Thank",
  "actions": [
    { "type": "add_comment", "value": { "body": "Thanks for contacting us!", "is_public": true } },
    { "type": "set_status", "value": "solved" },
    { "type": "add_tags", "value": ["resolved"] }
  ]
}

{ "ticket_id": "ticket_uuid" }

{
  "name": "Auto-assign billing tickets",
  "event_type": "ticket_created",
  "conditions": {
    "all": [{ "field": "category", "operator": "is", "value": "billing" }]
  },
  "actions": [
    { "type": "set_group", "field": "group_id", "value": "billing_group_uuid" },
    { "type": "set_priority", "field": "priority", "value": "high" }
  ]
}

{
  "name": "Follow up on stale tickets",
  "conditions": {
    "all": [
      { "field": "status", "operator": "is", "value": "pending" },
      { "field": "hours_since_updated", "operator": "greater_than", "value": 48 }
    ]
  },
  "actions": [
    { "type": "add_comment", "value": { "body": "Just checking in..." } },
    { "type": "set_status", "value": "open" }
  ]
}

{
  "name": "My urgent tickets",
  "conditions": {
    "all": [{ "field": "priority", "operator": "is", "value": "urgent" }],
    "any": [
      { "field": "status", "operator": "is", "value": "new" },
      { "field": "status", "operator": "is", "value": "open" }
    ]
  },
  "columns": ["subject", "requester", "status", "priority", "updated_at"],
  "sort_by": "created_at",
  "sort_order": "desc"
}

{
  "name": "Urgent SLA",
  "first_response_target": 30,
  "resolution_target": 240,
  "conditions": { "priority": ["urgent", "high"] },
  "priority": 10
}

{
  "name": "Billing Queue",
  "routing_rules": [
    { "conditions": { "category": "billing" }, "assign_to_group": "group_uuid" }
  ],
  "default_sla_id": "sla_uuid"
}

{
  "name": "US Business Hours",
  "timezone": "America/New_York",
  "schedule": {
    "monday": { "start": "09:00", "end": "17:00" },
    "friday": { "start": "09:00", "end": "17:00" }
  },
  "holidays": [{ "date": "2025-12-25", "name": "Christmas" }]
}

{
  "name": "Acme Support",
  "subdomain": "acme",
  "support_email": "[email protected]",
  "brand_color": "#3B82F6",
  "help_center_enabled": true
}

{
  "name": "Main Support Email",
  "channel_type": "email",
  "config": { "email_address": "[email protected]" },
  "brand_id": "brand_uuid"
}

{
  "name": "Product Line",
  "key": "product_line",
  "field_type": "select",
  "options": [
    { "label": "Enterprise", "value": "enterprise" },
    { "label": "Starter", "value": "starter" }
  ],
  "is_required": true,
  "visible_to_customers": true
}

{
  "name": "Billing Issue Form",
  "field_ids": ["field_uuid_1", "field_uuid_2"],
  "is_default": false
}

{ "name": "Getting Started", "description": "Learn the basics", "icon": "BookOpen" }

{ "name": "Account Setup", "category_id": "cat_uuid" }

{
  "title": "How to reset your password",
  "body": "# Reset Your Password\n\nFollow these steps...",
  "section_id": "section_uuid",
  "status": "published",
  "labels": ["password", "account"],
  "promoted": true
}

{ "value": 1 }

{
  "locale": "fr",
  "title": "Guide de réinitialisation du mot de passe",
  "body": "Si vous avez oublié votre mot de passe...",
  "status": "draft"
}

{ "ticket_id": "ticket_uuid" }

{ "ticket_id": "ticket_uuid", "tone": "empathetic", "language": "en" }

{ "ticket_id": "ticket_uuid" }

{ "text": "This is unacceptable. I've been waiting for days!" }

{ "ticket_id": "ticket_uuid" }

curl -H "Authorization: Bearer kunya_YOUR_KEY" \
  "https://kunya.ai/api/v1/support/analytics/overview?start_date=2025-01-01&end_date=2025-01-31"

{
  "name": "Slack Integration",
  "url": "https://hooks.slack.com/services/...",
  "events": ["ticket.created", "ticket.updated", "ticket.solved", "comment.added", "csat.received"]
}

# Vercel cron runs automatically
# Manual trigger:
curl -H "Authorization: Bearer YOUR_CRON_SECRET" \
  https://api.kunya.ai/api/cron/support-automations

# 1. Configure SendGrid Inbound Parse:
#    - Domain: support.yourdomain.com
#    - URL: https://api.kunya.ai/api/v1/support/inbound-email
#
# 2. Set MX records for support.yourdomain.com -> mx.sendgrid.net
#
# 3. (Optional) Set INBOUND_EMAIL_SECRET env var for webhook verification
#
# Inbound emails are parsed and:
# - If replying to existing ticket (via In-Reply-To header or [#123] in subject):
#   → Adds customer comment, reopens if pending/solved
# - If new email:
#   → Creates customer + ticket with channel='email'
#   → Sends confirmation email to customer

{
  "email": "[email protected]",
  "workspace_id": "ws_xxx"
}

{
  "email": "[email protected]",
  "workspace_id": "ws_xxx",
  "code": "482913"
}
// Response:
{
  "token": "kunya_portal_abc123...",
  "expires_at": "2026-04-03T00:00:00Z",
  "customer": { "id": "...", "name": "...", "email": "..." }
}

curl -H "Authorization: Bearer kunya_portal_abc123..." \
  https://api.kunya.ai/api/v1/support/portal/tickets

{
  "subject": "I can't reset my password",
  "description": "When I click the reset link, it shows a 404 error.",
  "priority": "normal"
}

{ "score": 5, "comment": "Fast and helpful!" }

# Browse by category
curl "https://api.kunya.ai/api/v1/support/portal/articles?workspace_id=ws_xxx&category=getting-started"

# Full-text search
curl "https://api.kunya.ai/api/v1/support/portal/articles?workspace_id=ws_xxx&q=password+reset"

const eventSource = new EventSource(
  'https://api.kunya.ai/api/v1/support/events/stream?since=2026-03-01T00:00:00Z',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Ticket event:', data);
  // {
  //   id: "event-uuid",
  //   ticket_id: "ticket-uuid",
  //   event_type: "status_changed",
  //   actor_type: "agent",
  //   actor_name: "John Doe",
  //   changes: { status: { from: "open", to: "solved" } },
  //   created_at: "2026-03-03T14:30:00Z"
  // }
};

// Reconnect with last event ID for seamless recovery
eventSource.onerror = () => {
  // EventSource auto-reconnects; use 'since' param with last received timestamp
};

# Search all types
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.kunya.ai/api/v1/support/search?q=password+reset&type=all"

# Search only tickets
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.kunya.ai/api/v1/support/search?q=billing+issue&type=tickets&limit=20"

# Response:
{
  "tickets": [
    { "id": "...", "ticket_number": 1234, "subject": "...", "status": "open", "rank": 0.85 }
  ],
  "articles": [
    { "id": "...", "title": "...", "slug": "...", "rank": 0.72 }
  ],
  "total_tickets": 12,
  "total_articles": 3
}

{
  "linked_ticket_id": "ticket-uuid",
  "relationship_type": "problem"  // problem, incident, related, cause
}

# Filter by type, sort by votes
curl -H "X-API-Key: KEY" \
  "https://api.kunya.ai/api/v1/support/community/posts?post_type=question&sort=upvotes&topic_id=xxx"

{
  "title": "How do I integrate with the billing API?",
  "body": "I'm trying to connect Stripe webhooks but...",
  "post_type": "question",
  "topic_id": "category-uuid"
}

{ "body": "Try checking the webhook signature...", "parent_id": "comment-uuid" }

{ "ticket_id": "ticket-uuid", "activity": "viewing" }

curl -H "Authorization: Bearer kunya_YOUR_KEY" \
  "https://kunya.ai/api/v1/support/agents/status?status=online&skill=billing&online_only=true"

{
  "status": "online",
  "status_message": "Available for chats",
  "max_capacity": 10,
  "skills": ["billing", "technical", "refunds"],
  "channels": ["chat", "email", "phone"]
}

{
  "name": "Weekly Ticket Overview",
  "report_type": "overview",
  "frequency": "weekly",
  "format": "csv",
  "recipient_emails": ["[email protected]", "[email protected]"],
  "filters": { "priority": "urgent" }
}

# Report types: overview, agents, sla, csat, tickets
# Overview: ticket counts by status, priority, channel
# Agents: per-agent resolution stats
# SLA: breach rates and compliance
# CSAT: satisfaction scores breakdown
# Tickets: full ticket list with all fields

{
  "name": "Senior Agent",
  "description": "Can manage tickets and view reports",
  "permissions": {
    "tickets": { "view": "all", "create": true, "update": true, "delete": false },
    "customers": { "view": true, "create": true, "update": true, "delete": false },
    "reports": { "view": true },
    "admin": { "manage_triggers": false, "manage_slas": false, "manage_roles": false }
  }
}

{ "user_id": "user-uuid" }

{
  "call_id": "call-uuid",
  "caller_phone": "+1234567890",
  "caller_name": "Jane Doe",
  "subject": "Billing question",
  "description": "Customer called about a charge on their account.",
  "transcript": "Agent: Hello, how can I help?\nCaller: I see a charge...",
  "agent_id": "voice-agent-uuid",
  "priority": "normal"
}

{
  "ticket_id": "ticket-uuid",
  "call_id": "call-uuid",
  "transcript": "Follow-up call transcript...",
  "summary": "Customer confirmed the issue is resolved.",
  "resolution": "solved"
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://kunya.ai/api/v1/blog/posts?status=published&limit=20&offset=0"

{
  "title": "Your Article Title",
  "html_content": "<p>Article HTML content...</p>",
  "excerpt": "Short summary for previews",
  "category": "AI Tools",
  "tags": ["ai", "tools", "productivity"],
  "focus_keyword": "ai tools",
  "meta_title": "Best AI Tools 2026",
  "meta_description": "Discover the best AI tools...",
  "status": "draft",
  "locale": "en"
}

{
  "title": "How to Use AI for Content Marketing",
  "brief": "Guide on leveraging AI tools for marketing",
  "model": "claude-sonnet-4.6",
  "target_length": "medium",
  "tone": "professional",
  "voice_profile_id": "optional-uuid",
  "seo_keywords": ["ai content marketing", "ai writing tools"],
  "include_faq": true,
  "include_examples": true
}

{
  "context": "<p>Existing article content...</p>",
  "title": "Article Title",
  "model": "claude-sonnet-4.6",
  "paragraph_count": 3,
  "edit_mode": "continue",
  "voice_profile_id": "optional-uuid"
}

{
  "objective": "Write 5 articles about AI productivity tools",
  "instructions": "Target 1200 words each, professional tone",
  "model": "claude-sonnet-4.6",
  "image_model": "gpt-image-2",
  "image_strategy": "ai_generated",
  "voice_profile_id": "optional-uuid",
  "auto_publish": false
}

{
  "edit_instruction": "Update the Pricing section: GPT-4o input is now $3.25/M tokens, output $13/M tokens",
  "filter": {
    "destination": "models",
    "status": "published",
    "category": "AI Models",
    "locale": "en",
    "post_ids": ["uuid-1", "uuid-2"],
    "search_query": "GPT"
  },
  "model": "gpt-5-mini",
  "dry_run": false
}

{ "type": "start", "total_posts": 12, "dry_run": false, "model": "gpt-5-mini" }
{ "type": "progress", "post_id": "uuid", "title": "GPT-4o Overview", "status": "edited", "changed": true, "diff": { "before": "...", "after": "..." } }
{ "type": "progress", "post_id": "uuid", "title": "Claude Overview", "status": "skipped", "changed": false }
{ "type": "done", "summary": { "total": 12, "edited": 3, "skipped": 8, "failed": 1 }, "dry_run": false }

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://kunya.ai/api/v1/blog/tasks?status=running&limit=10"

{
  "data": {
    "id": "task-uuid",
    "status": "completed",
    "progress": 100,
    "total_steps": 5,
    "current_step": 5,
    "result_summary": "Done: 5 articles created, 0 failed.",
    "subtasks": [
      { "id": "...", "objective": "Article Title", "status": "completed", "result_summary": "1200 words + AI cover image" }
    ]
  }
}

{
  "data": {
    "post_id": "uuid",
    "unique_views": 342,
    "avg_scroll_depth": 76,
    "read_complete_rate": 45,
    "avg_time_on_page_seconds": 187,
    "search_metrics": [
      { "query": "ai writing tools", "impressions": 1200, "clicks": 89, "position": 4.2 }
    ]
  }
}

{
  "data": {
    "total": 42,
    "entries": [
      {
        "slug": "ai-content-marketing-guide",
        "title": "AI Content Marketing Guide",
        "locale": "en",
        "last_modified": "2026-03-01T12:00:00Z",
        "urls": {
          "en": "https://kunya.ai/blog/ai-content-marketing-guide",
          "pl": "https://kunya.pl/blog/ai-content-marketing-guide"
        }
      }
    ]
  }
}

{
  "show_table_of_contents": true,
  "toc_position": "sidebar",
  "posts_per_page": 12,
  "show_social_share": true,
  "show_related_posts": true
}

{
  "messages": [
    { "role": "user", "content": "Write an introduction about AI in healthcare" }
  ],
  "model": "claude-sonnet-4.6",
  "article_title": "AI in Healthcare: A Complete Guide",
  "editor_content": "<p>Current article HTML...</p>",
  "voice_profile_id": "optional-uuid",
  "enable_web_search": true
}

{
  "prompt": "A futuristic AI-powered content creation workspace",
  "model": "gpt-image-2",
  "type": "cover",
  "style": "professional",
  "quality": "medium",
  "article_title": "The Future of AI Content"
}

{
  "data": {
    "url": "https://...",
    "revised_prompt": "...",
    "model": "gpt-image-2",
    "type": "cover",
    "style": "professional",
    "cost": 0.053
  }
}

{
  "messages": [
    { "role": "user", "content": "Analyze my blog's SEO health and suggest improvements" }
  ],
  "model": "gemini-3.5-flash"
}

{
  "data": {
    "content": "## Blog SEO Analysis\n\nI analyzed your 24 articles...\n\n### Issues Found\n- 8 articles missing meta descriptions\n- 3 articles with 'Uncategorized' category...",
    "model": "gemini-3.5-flash"
  }
}

{
  "target_locale": "pl",
  "model": "gemini-3.5-flash"
}

{"step":"metadata","progress":15,"message":"Translating metadata to polski..."}
{"step":"content","progress":40,"message":"Translating content (~1200 words)..."}
{"step":"complete","progress":100,"done":true,"id":"new-post-uuid","title":"Translated Title","locale":"pl"}

{
  "data": {
    "id": "new-post-uuid",
    "slug": "original-slug-copy",
    "title": "Original Title (Copy)",
    "status": "draft"
  }
}

{
  "name": "AI Tools",
  "description": "Reviews and guides for AI tools",
  "color": "#7c3aed",
  "sort_order": 1
}

{
  "objective": "Plan Q2 content calendar for AI productivity",
  "timeframe": "Q2 2026",
  "focus_areas": ["AI writing", "automation", "SEO"],
  "target_audience": "Small business marketers"
}

{
  "name": "Long-form Guide",
  "description": "Template for comprehensive guides",
  "layout": { "sections": ["hero", "toc", "content", "faq", "cta"] },
  "is_default": false,
  "is_public": false
}

{
  "name": "Space Explorer",
  "description": "A 3D space exploration game",
  "color": "#6366f1"
}

{
  "projectId": "uuid",
  "name": "Level 2 - Forest",
  "code": "// Three.js code here..."
}

{
  "id": "scene-uuid",
  "name": "Boss Arena",
  "transitionType": "fade",
  "transitionDuration": 1000,
  "triggerType": "coordinates",
  "triggerConfig": { "x": 50, "z": 50, "radius": 5 }
}

{
  "projectId": "uuid (optional - omit to create new project)",
  "sceneId": "uuid (optional - omit to create new scene)",
  "name": "My Game",
  "code": "// bundled Three.js code",
  "files": {
    "files": {
      "src/main.js": { "content": "// entry point...", "language": "javascript" },
      "src/entities/player.js": { "content": "// player code...", "language": "javascript" },
      "src/systems/physics.js": { "content": "// physics...", "language": "javascript" }
    }
  },
  "chatMessages": [],
  "codeHistory": []
}

{
  "modelId": "claude-4-sonnet",
  "prompt": "Add a particle system that follows the mouse cursor",
  "currentCode": "// current Three.js code...",
  "messages": [
    { "role": "user", "content": "Create a spinning cube" },
    { "role": "assistant", "content": "Here's a cube..." }
  ],
  "graphicsPreset": "enhanced"
}

{
  "modelId": "claude-4-sonnet",
  "prompt": "Add enemy spawning in a new file",
  "mode": "tools",
  "vfsFiles": {
    "src/main.js": { "content": "...", "language": "javascript" },
    "src/entities/player.js": { "content": "...", "language": "javascript" }
  },
  "messages": [],
  "graphicsPreset": "basic"
}

{
  "projectId": "uuid",
  "modelId": "claude-4-sonnet"
}

{
  "overall_score": 78,
  "accuracy_score": 74,
  "fluency_score": 82,
  "prosody_score": 80,
  "transcribed_text": "Je voudrais un cafe sil vous plait",
  "words": [
    {
      "word": "voudrais",
      "spoken": "voudrai",
      "score": 65,
      "feedback": "The final 's' in 'voudrais' is silent but the 'ai' should be more open, like 'eh'"
    },
    {
      "word": "s'il",
      "spoken": "sil",
      "score": 90,
      "feedback": null
    }
  ],
  "tempo_analysis": {
    "words_per_minute": 95,
    "assessment": "slightly slow — target ~120 wpm for natural French"
  },
  "overall_feedback": "Good attempt! Focus on the nasal vowels and the open 'ai' sound in conditional verb forms.",
  "recommended_practice": [
    "Practice 'ai/ais/ait' endings: voudrais, aimerais, pourrais",
    "Listen and repeat: French conditional tense phrases at natural speed"
  ],
  "target_text": "Je voudrais un café, s'il vous plaît",
  "language": "fr",
  "cost": 0.012
}

{
  "level": "B2",
  "sub_level": "B2.1",
  "confidence": 0.91,
  "readability_score": 45,
  "breakdown": {
    "vocabulary": { "level": "B2", "notes": "Contains academic vocabulary and low-frequency terms" },
    "grammar": { "level": "B2", "notes": "Uses passive voice, relative clauses, and conditional structures" },
    "sentence_complexity": { "level": "C1", "notes": "Several multi-clause sentences with embedded subordination" },
    "topic_familiarity": { "level": "B2", "notes": "Specialized (technology) but accessible to informed readers" }
  },
  "statistics": {
    "word_count": 247,
    "avg_sentence_length": 18.2,
    "unique_vocabulary_ratio": 0.68,
    "estimated_vocabulary_level": 5200
  },
  "suitable_for": "Upper-intermediate learners (B2+) with interest in technology topics",
  "language": "en",
  "cost": 0.003
}

{
  "corrected_text": "Yesterday I went to the store and bought some apples.",
  "error_count": 3,
  "errors": [
    {
      "original": "go",
      "correction": "went",
      "category": "verb_tense",
      "severity": "major",
      "explanation": "Use past simple ('went') for completed actions in the past. 'Yesterday' signals past tense.",
      "rule": "Past simple for completed past actions"
    },
    {
      "original": "buyed",
      "correction": "bought",
      "category": "verb_tense",
      "severity": "major",
      "explanation": "'Buy' is an irregular verb. The past form is 'bought', not 'buyed'.",
      "rule": "Irregular past tense"
    },
    {
      "original": "some apple",
      "correction": "some apples",
      "category": "plural",
      "severity": "minor",
      "explanation": "'Some' is used with plural countable nouns: 'some apples'.",
      "rule": "Countable noun plurals with quantifiers"
    }
  ],
  "error_summary": { "verb_tense": 2, "plural": 1 },
  "overall_accuracy": 72,
  "strengths": ["Good sentence structure", "Correct use of articles"],
  "focus_areas": ["Irregular past tense forms", "Countable/uncountable noun agreement"],
  "language": "en",
  "cost": 0.004
}

{
  "level": "B1",
  "sub_level": "B1.2",
  "confidence": 0.87,
  "skill": "writing",
  "breakdown": {
    "vocabulary_range": { "level": "B1", "notes": "~3200 active lemmas, adequate for familiar topics" },
    "grammatical_accuracy": { "level": "A2+", "notes": "Subjunctive used correctly 2/5 times, consistent article errors" },
    "fluency_coherence": { "level": "B2", "notes": "Good paragraph organization, logical connectors" },
    "task_achievement": { "level": "B1", "notes": "Addresses the topic but lacks nuanced argumentation" }
  },
  "evidence": [
    "Used past subjunctive correctly: 'Si yo tuviera más tiempo...'",
    "Vocabulary range covers travel, daily life, and some workplace topics",
    "Self-corrected errors in 60% of cases"
  ],
  "strengths": ["Good use of discourse markers", "Natural paragraph flow"],
  "weaknesses": ["Inconsistent subjunctive mood", "Limited use of passive voice"],
  "recommended_focus": ["subjunctive_mood", "passive_voice", "idiomatic_expressions"],
  "estimated_vocabulary_size": 3200,
  "next_level_requirements": "To reach B2: master subjunctive in all tenses, expand vocabulary to 4500+ lemmas, develop ability to argue and hypothesize",
  "language": "es",
  "cost": 0.015
}

{
  "items": [
    {
      "term": "durchsetzen",
      "lemma": "durchsetzen",
      "part_of_speech": "verb",
      "definition": "etwas gegen Widerstand erreichen oder verwirklichen",
      "translation": "to enforce / to push through",
      "example_sentence": "Die Regierung konnte die neue Regelung nicht durchsetzen.",
      "frequency_band": "top_5000",
      "cefr_level": "B2",
      "context_from_text": "...versuchte, ihre Interessen durchzusetzen...",
      "notes": "Separable verb: 'Er setzt seine Meinung durch.' Reflexive form 'sich durchsetzen' means 'to prevail'."
    }
  ],
  "text_cefr_level": "B2",
  "total_unique_words": 187,
  "items_above_learner_level": 12,
  "language": "de",
  "learner_level": "B1",
  "cost": 0.005
}

{
  "name": "French Tutor",
  "template_id": "template-language-tutor",
  "instructions": "You are teaching French to an English speaker at B1 level. Focus on conversational fluency and the subjunctive mood. The learner is preparing for DELF B2.",
  "config": {
    "tone": "friendly",
    "memoryEnabled": true
  }
}

{
  "workspacePath": "/Users/dev/my-project",
  "files": [
    { "relativePath": "src/app.ts", "content": "export function main() {}" },
    { "relativePath": "src/removed.ts", "deleted": true }
  ]
}

{
  "workspacePath": "/Users/dev/my-project",
  "query": "authentication middleware",
  "limit": 10
}

{
  "workspacePath": "/Users/dev/my-project",
  "messages": [{ "role": "user", "content": "Fix the login error handling" }],
  "pinnedFiles": ["src/auth/login.ts"],
  "activeFile": "src/auth/login.ts",
  "workspaceRules": "From AGENTS.md and .cursor/rules",
  "mentionedFiles": [{ "path": "src/auth/login.ts", "content": "..." }],
  "model": "claude-sonnet-4.6"
}

{
  "filePath": "src/utils.ts",
  "language": "typescript",
  "instruction": "add null check",
  "selectedText": "return user.name;"
}

{
  "filePath": "src/app.ts",
  "language": "typescript",
  "prefix": "export function hello() {\n  const x = ",
  "suffix": "\n}"
}

{ "data": { "completion": "42;" } }

{
  "postId": "uuid",
  "label": "Before major rewrite"
}

{
  "name": "Blog Review Pipeline",
  "stages": ["Draft", "Editor Review", "Legal Review", "Approved", "Published"]
}

{
  "postId": "uuid",
  "workflowId": "uuid"
}

{
  "name": "Spring Launch 2026",
  "scheduledAt": "2026-04-01T09:00:00Z",
  "postIds": ["uuid1", "uuid2", "uuid3"]
}

{
  "name": "Marketing Blog",
  "url": "https://blog.example.com",
  "webhookUrl": "https://blog.example.com/api/content-hook",
  "secret": "whsec_..."
}

{
  "name": "Product Update",
  "fields": [
    { "name": "version", "type": "string", "required": true },
    { "name": "changelog", "type": "richtext", "required": true },
    { "name": "releaseDate", "type": "date", "required": false }
  ]
}

{
  "data": {
    "version": "2.5.0",
    "changelog": "<p>Added CMS support...</p>",
    "releaseDate": "2026-05-10"
  }
}

{
  "format": "csv",
  "data": "title,content,category\nMy Post,<p>Hello world</p>,News",
  "publish": false
}