Errors

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Content exceeds maximum length for Twitter (280 characters)",
    "details": {
      "field": "content",
      "platform": "TWITTER",
      "maxLength": 280,
      "actualLength": 312
    }
  }
}

curl -X POST https://api.voxburst.io/v1/posts \
  -H "Authorization: Bearer vb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "content": "Hello!", "accountIds": ["acc_instagram_abc"] }'

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Content is required for Instagram posts",
    "details": { "platform": "INSTAGRAM", "reason": "MEDIA_REQUIRED" }
  }
}

curl -X POST https://api.voxburst.io/v1/posts/validate \
  -H "Authorization: Bearer vb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "content": "This is a very long tweet that exceeds the 280 character limit. Lorem ipsum dolor sit amet consectetur adipiscing elit sed do eiusmod tempor incididunt ut labore et dolore magna aliqua ut enim ad minim veniam quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat duis aute irure dolor.", "platforms": ["TWITTER"] }'

{
  "valid": false,
  "platforms": {
    "TWITTER": {
      "valid": false,
      "errors": [
        { "code": "CONTENT_TOO_LONG", "message": "Content exceeds maximum length for Twitter (280 characters). Current: 321 characters." }
      ],
      "warnings": []
    }
  }
}

curl -X POST https://api.voxburst.io/v1/posts \
  -H "Authorization: Bearer vb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "content": "Old post", "accountIds": ["acc_abc"], "scheduledFor": "2025-01-01T00:00:00Z" }'

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Scheduled time must be in the future",
    "details": { "field": "scheduledFor" }
  }
}

curl -X POST https://api.voxburst.io/v1/posts \
  -H "Authorization: Bearer vb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "content": "Photo post", "accountIds": ["acc_ig"], "contentType": "IMAGE", "media": ["media_still_processing"] }'

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Media media_still_processing is not ready for publishing (status: PROCESSING)"
  }
}

curl -X POST https://api.voxburst.io/v1/posts/bulk \
  -H "Authorization: Bearer vb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "posts": [ ... 51 items ... ] }'

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Maximum 50 posts per bulk request",
    "details": { "field": "posts", "max": 50, "actual": 51 }
  }
}

curl -X POST https://api.voxburst.io/v1/posts \
  -H "Authorization: Bearer vb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Thread",
    "accountIds": ["acc_twitter"],
    "contentType": "THREAD",
    "threadPosts": [
      { "sequence": 1, "content": "First tweet" },
      { "sequence": 3, "content": "Third tweet — sequence 2 is missing!" }
    ]
  }'

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Thread post sequences must be 1-based and contiguous",
    "details": { "field": "threadPosts" }
  }
}

curl https://api.voxburst.io/v1/posts/not-a-valid-id \
  -H "Authorization: Bearer vb_live_xxxxx"

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid path parameter 'id': Invalid ID format"
  }
}

curl -X PATCH https://api.voxburst.io/v1/posts/post_abc \
  -H "Authorization: Bearer vb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "content": "Updated content", "version": "2026-06-01T10:00:00.000Z" }'

{
  "error": {
    "code": "CONFLICT",
    "message": "Post has been modified since you last loaded it. Re-fetch and retry.",
    "details": { "field": "version" }
  }
}