---
title: "Send up to 100 messages"
method: POST
path: "/messages/batch"
---

# Send up to 100 messages

`POST /messages/batch`

## Request

- Base URL: `https://worker.openhelm.ai/v1`
- URL: `https://worker.openhelm.ai/v1/messages/batch`
- Auth: HTTP bearer

PARTIAL SUCCESS is normal and is not an HTTP error: every item reports its own `status` and `error`, and the request is 202 regardless. A daily-cap failure stops the remainder rather than retrying it 99 times, and says so on each unattempted item.

## Request body

- object
  - `inbox_id` string, required
  - `messages` object[], required: Each needs its own client_id.

## Response `202`

Per-item outcomes

---

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