---
title: "Batch public read operations"
method: POST
path: "/batch"
tags: ["agents"]
---

# Batch public read operations

`POST /batch`

## Request

- Base URL: `https://mana.am`
- URL: `https://mana.am/batch`
- Auth: none required

Combines up to 10 read-only public Mana operations in one request so agents can avoid request waterfalls.

## Headers

- `Mana-API-Version` string
- `Idempotency-Key` string

## Request body

- BatchRequest
  - `requests` object[], required
    - `id` union: Client correlation id.
      - string
      - integer
    - `operation` 'search_community_apps' | 'get_popular_tags' | 'get_creator_profile' | 'get_app_share', required
    - `arguments` object

## Response `200`

Per-request batch responses.

- BatchResponse
  - `responses` object[], required
    - `id` union, required
      - string
      - integer
    - `ok` boolean, required
    - `data` object
    - `error` string

## Other responses

- `400`: Invalid batch body.
- `429`: Rate limit exceeded. Public reads allow 120 requests per 60 seconds; agent discovery and MCP probes allow 60 requests per 60 seconds. Retry after the provided Retry-After or RateLimit-Reset window.
- `500`: Unexpected server error. Retry later or check status documentation before repeating automated requests.

---

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