---
title: "Run several reads in one request"
method: POST
path: "/api/v1/batch"
tags: ["agents"]
---

# Run several reads in one request

`POST /api/v1/batch`

## Request

- Base URL: `https://justautomate.ai`
- URL: `https://justautomate.ai/api/v1/batch`
- Auth: one of:
  - none
  - OAuth 2 (authorization code, authorization URL `https://justautomate.ai/oauth/authorize/`, token URL `https://justautomate.ai/oauth/token/`, scopes: `mcp:read`)

Runs 1 to 10 GET operations on /api/v1 endpoints (except batch and identity) and returns each status and body in order. Read-only and free of side effects, so it is always safe to retry; counts as one request against the rate limit. An optional Idempotency-Key is accepted and echoed back.

## Headers

- `Idempotency-Key` string

## Request body

- BatchRequest
  - `requests` object[], required
    - `id` union: Echoed back in the result; defaults to the position.
      - string
      - integer
    - `method` 'GET'
    - `path` string, required: Path with query string, e.g. "/api/v1/search?q=workshop".

## Response `200`

Results in request order.

- BatchResponse
  - `responses` object[], required
    - `id` union, required
      - string
      - integer
    - `status` integer, required
    - `body` object, required: The body the same GET would return: its success schema or Problem.

## Other responses

- `400`: A parameter or the request body is invalid (code invalid-parameter or invalid-body).
- `401`: The bearer token is invalid or expired (code invalid-token). Call without a token or get a new one.
- `413`: The request body is too large (code payload-too-large).
- `415`: The request body is not JSON (code unsupported-media-type).
- `429`: Rate limit exceeded (code rate-limited). Wait Retry-After seconds.
- `500`: Unexpected error (code internal-error). Retry later.

---

[API](https://skmtc.dev/justautomate/apis/justautomate-public-api.md) · [All operations](https://skmtc.dev/justautomate/apis/justautomate-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/justautomate/apis/justautomate-public-api/revisions/b42d0226be7e?raw)