AI Generation

https://api.voxburst.io/v1

curl -X POST https://api.voxburst.io/v1/ai/generate-post-content \
  -H "Authorization: Bearer vb_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "systemPrompt": "<assembled persona system prompt>",
    "userPrompt": "Write a post about our new product launch.",
    "platform": "linkedin"
  }'

{
  "content": "Excited to announce our latest product...",
  "provider": "anthropic",
  "model": "claude-3-5-sonnet",
  "truncated": false
}

// 1. Assemble the persona prompt
const assembled = await fetch(
  `https://api.voxburst.io/v1/personas/${personaId}/runtime/assemble`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer vb_live_xxxxxxxxxxxxx',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      platform: 'linkedin',
      generationType: 'POST_GENERATION',
      ideaInput: 'quarterly sustainability report results',
    }),
  }
).then(r => r.json())
 
// 2. Generate post content
const generated = await fetch(
  'https://api.voxburst.io/v1/ai/generate-post-content',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer vb_live_xxxxxxxxxxxxx',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      systemPrompt: assembled.systemPrompt,
      userPrompt: assembled.userPrompt,
      platform: 'linkedin',
    }),
  }
).then(r => r.json())
 
console.log(generated.content)

curl -X POST https://api.voxburst.io/v1/ai/enhance-content \
  -H "Authorization: Bearer vb_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "We launched something new today.",
    "tone": "enthusiastic",
    "platform": "twitter"
  }'

{
  "enhanced": "Big news — we just launched something new today! 🚀",
  "provider": "anthropic",
  "model": "claude-3-5-sonnet",
  "credits_used": 1,
  "credits_remaining": 149
}

{
  "original": "raw text",
  "enhanced": "improved text",
  "suggestions": ["..."],
  "changes": ["Added emojis", "Shortened sentences"],
  "platform": "instagram"
}

curl -X POST https://api.voxburst.io/v1/ai/hashtags \
  -H "Authorization: Bearer vb_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Just published our 2026 sustainability report.",
    "platform": "linkedin"
  }'

{
  "hashtags": ["#sustainability", "#ESG", "#corporateresponsibility"],
  "relevanceScores": { "#sustainability": 0.95, "#ESG": 0.91 },
  "suggestions": [
    { "tag": "sustainability", "relevance": 0.95, "trending": false }
  ]
}

{ "platforms": ["twitter", "linkedin"] }

{
  "heatmap": [
    { "day": 0, "hour": 0, "score": 20 },
    { "day": 2, "hour": 9, "score": 80 }
  ],
  "recommendation": {
    "date": "2026-04-29",
    "time": "09:00",
    "dayName": "Tuesday",
    "engagement": "high",
    "reason": "Tuesdays at 9am consistently show the highest engagement window for LinkedIn."
  }
}

curl https://api.voxburst.io/v1/ai/suggest-time/acc_abc123 \
  -H "Authorization: Bearer vb_live_xxxxxxxxxxxxx"

{
  "accountId": "acc_abc123",
  "platform": "twitter",
  "suggestedTime": "2026-04-29T09:00:00Z",
  "timezone": "America/Chicago",
  "confidence": 0.82,
  "reasoning": "Your audience is most active on Tuesday mornings.",
  "alternatives": [{ "time": "2026-04-30T14:00:00Z", "score": 0.74 }]
}

{
  "configured": true,
  "enabled": true,
  "provider": "anthropic",
  "model": "claude-3-5-sonnet",
  "lastUpdated": "2026-04-10T08:00:00Z"
}

QUEUED → PROCESSING → COMPLETED
              ↓
           PAUSED (insufficient credits mid-run)
              ↓
           PROCESSING (after resume)
              ↓
           CANCELLED (user cancel) / FAILED (unrecoverable error)

{
  "valid": true,
  "error": null,
  "creditBalance": 200,
  "estimatedCredits": 20
}

{
  "valid": false,
  "error": "Insufficient credits",
  "creditBalance": 5,
  "estimatedCredits": 20
}

curl -X POST https://api.voxburst.io/v1/bulk-generate \
  -H "Authorization: Bearer vb_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_abc123",
    "personaId": "pp_xyz456",
    "platform": "linkedin",
    "totalPosts": 5,
    "scheduledDates": [
      "2026-04-28T09:00:00Z",
      "2026-04-29T09:00:00Z",
      "2026-04-30T09:00:00Z",
      "2026-05-01T09:00:00Z",
      "2026-05-02T09:00:00Z"
    ],
    "topicHint": "product updates and sustainability"
  }'

{
  "jobId": "bgjob_abc123",
  "status": "QUEUED",
  "message": "Bulk generation job created successfully"
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits: need 20, have 5 usable",
    "required": 20,
    "available": 5
  }
}

{
  "job": {
    "id": "bgjob_abc123",
    "status": "PROCESSING",
    "totalPosts": 10,
    "completedPosts": 4,
    "failedPosts": 0,
    "skippedPosts": 0,
    "credits": {
      "reserved": 20,
      "consumed": 8,
      "refunded": 0,
      "remaining": 12
    },
    "progress": {
      "percentage": 40,
      "current": 4,
      "total": 10
    },
    "posts": [
      {
        "id": "post_abc",
        "status": "SCHEDULED",
        "scheduledFor": "2026-04-28T09:00:00Z"
      }
    ],
    "queuedAt": "2026-04-23T12:00:00Z",
    "startedAt": "2026-04-23T12:00:05Z",
    "completedAt": null
  }
}

{ "jobId": "bgjob_abc123", "status": "CANCELLED", "message": "Job cancelled and credits refunded." }

{ "jobId": "bgjob_abc123", "status": "PROCESSING", "message": "Job resumed." }

{
  "jobs": [
    {
      "id": "bgjob_abc123",
      "status": "COMPLETED",
      "totalPosts": 10,
      "completedPosts": 10,
      "failedPosts": 0,
      "progress": { "percentage": 100, "current": 10, "total": 10 },
      "credits": { "reserved": 20, "consumed": 20 },
      "createdAt": "2026-04-23T12:00:00Z",
      "completedAt": "2026-04-23T12:04:30Z"
    }
  ]
}