---
title: "Run a batch of blog post operations"
method: POST
path: "/blog/posts/batch"
tags: ["Blog posts"]
---

# Run a batch of blog post operations

`POST /blog/posts/batch`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/blog/posts/batch`
- Auth: HTTP bearer

Runs up to 50 blog post operations in a single request (5 MB body limit). Each sub-operation runs independently. A `publish`/`unpublish` sub-op uses `{ method: "POST", action: "publish", resourceId }` and requires `blog.publish`. Idempotency keys are honored on the batch itself, not on individual sub-operations.

## Request body

- BlogPostsBatchRequest
  - `operations` union[], required: Array of post sub-operations to execute. Each runs independently and reports on the matching entry of the response `data` array. `id` values must be unique. Supported: POST (create), PATCH (update), DELETE, and POST with action `publish`/`unpublish`. Up to 50 entries.
    - union
      - object
        - `id` string, required
        - `method` 'POST', required
        - `body` unknown
        - `action` string
        - `resourceId` string
      - object
        - `id` string, required
        - `method` 'PATCH', required
        - `body` unknown
        - `resourceId` string, required
      - object
        - `id` string, required
        - `method` 'DELETE', required
        - `resourceId` string, required

## Response `200`

Successful response. Inspect each entry of the `data` array for the per-sub-operation status.

- object
  - `object` 'batch_result', required
  - `data` object[], required
    - `id` string, required
    - `status` number, required
    - `data` unknown
    - `error` object
      - `code` string, required
      - `message` string, required
      - `details` unknown

## Other responses

- `413`: The request body exceeded 5 MB.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `413` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/blog/posts/batch/post.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)