---
title: "Run several read operations in one request"
method: POST
path: "/v1/batch"
tags: ["batch"]
---

# Run several read operations in one request

`POST /v1/batch`

## Request

- Base URL: `https://aicontentdrop.com`
- URL: `https://aicontentdrop.com/v1/batch`
- Auth: none required

Dispatches up to 20 GET operations against the public read surface and returns their results in one envelope, so an agent acting on many items does not spend one request per item.

**Reads only.** Generation is deliberately not batchable: a partial failure in a batch of money-spending calls leaves credits nobody can account for, so each generation keeps its own request and its own `Idempotency-Key`.

**Per-item status.** An operation that fails carries its own `status` and `error`; the envelope is still 200. No API key is required for the paths it accepts.

## Request body

- object
  - `operations` object[], required: The operations to run, in order.
    - `id` string: Your label for this operation, echoed in the result. Defaults to the array index.
    - `method` 'GET', required: Only GET is accepted.
    - `path` string, required: A read path: /v1/models or /v1/models/{id}/cost, with an optional query string.

## Response `200`

Every operation was dispatched. Inspect each result for its own status.

- object
  - `count` integer: Operations received.
  - `succeeded` integer: Operations that returned 200.
  - `results` object[]
    - `id` string
    - `status` integer: HTTP status this operation would have returned on its own.
    - `body` object, nullable: The operation result, or null when it failed.
    - `error` object, nullable
      - `code` string
      - `message` string

## Other responses

- `400`: No operations, more than 20, or a malformed envelope.
- `429`: Rate limited. Read Retry-After (header) or error.retry_after_seconds (body).
- `500`: Unexpected failure on our side. Retry once; nothing was charged.

---

[API](https://skmtc.dev/aicontentdrop/apis/ai-content-drop-api.md) · [All operations](https://skmtc.dev/aicontentdrop/apis/ai-content-drop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aicontentdrop/apis/ai-content-drop-api/revisions/75a13a8043ae?raw)