---
title: "Run a batch of redirect operations"
method: POST
path: "/redirects/batch"
tags: ["Redirects"]
---

# Run a batch of redirect operations

`POST /redirects/batch`

## Request

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

Runs up to 100 redirect operations in a single request, with a 5 MB request body limit. Each sub-operation runs independently. Idempotency keys are honored on the batch itself, not on individual sub-operations.

## Request body

- RedirectsBatchRequest
  - `operations` union[], required: Array of sub-operations to execute. Each entry runs independently and reports its result on the corresponding entry of the response `data` array. Sub-operation `id` values must be unique within the batch. Up to 100 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/redirects/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)