Batch

Perform multiple operations in a single API call. Batch operations support up to 100 items per request.

Base URL


https://api.voxburst.io/v1/batch

Batch Create Posts

POST /v1/batch/posts

Create up to 100 posts in a single request.

Required scopes: posts:write


curl -X POST https://api.voxburst.io/v1/batch/posts \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "posts": [
      {
        "content": "First post in the batch!",
        "platforms": ["TWITTER"],
        "accountIds": ["acc_123"],
        "scheduledFor": "2026-03-01T09:00:00Z"
      },
      {
        "content": "Second post in the batch!",
        "platforms": ["LINKEDIN"],
        "accountIds": ["acc_456"],
        "scheduledFor": "2026-03-01T10:00:00Z"
      }
    ]
  }'

Response


{
  "results": [
    {
      "index": 0,
      "success": true,
      "post": {
        "id": "post_aaa111",
        "status": "SCHEDULED"
      }
    },
    {
      "index": 1,
      "success": true,
      "post": {
        "id": "post_bbb222",
        "status": "SCHEDULED"
      }
    }
  ],
  "summary": {
    "total": 2,
    "succeeded": 2,
    "failed": 0
  }
}

Batch requests are processed atomically per item — a failure in one post does not affect others. Check each item’s success field in the response.

Batch Delete Posts

DELETE /v1/batch/posts

Delete up to 100 posts in a single request.

Required scopes: posts:write


curl -X DELETE https://api.voxburst.io/v1/batch/posts \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "postIds": ["post_aaa111", "post_bbb222", "post_ccc333"]
  }'

Response


{
  "results": [
    { "id": "post_aaa111", "success": true },
    { "id": "post_bbb222", "success": true },
    { "id": "post_ccc333", "success": false, "error": "Post not found" }
  ],
  "summary": {
    "total": 3,
    "succeeded": 2,
    "failed": 1
  }
}

TypeScript SDK


import { VoxBurstClient } from '@voxburst/sdk'
 
const client = new VoxBurstClient({ apiKey: process.env.VOXBURST_API_KEY })
 
// Batch create
const results = await client.batch.createPosts([
  {
    content: 'Post 1',
    platforms: ['TWITTER'],
    accountIds: ['acc_123'],
  },
  {
    content: 'Post 2',
    platforms: ['LINKEDIN'],
    accountIds: ['acc_456'],
  },
])
 
console.log(`Created ${results.summary.succeeded} posts`)