---
title: "Broadcast Command"
method: POST
path: "/api/v1/broadcast"
---

# Broadcast Command

`POST /api/v1/broadcast`

## Request

- Base URL: `http://127.0.0.1:8052`
- URL: `http://127.0.0.1:8052/api/v1/broadcast`
- Auth: none declared

Send a message to all running agents via fastest available channel.

Uses stdin pipe where available (sub-second delivery), falls back
to file-based COMMAND signal for agents without pipe support.

Expects JSON body: ``{"message": "some instruction"}``.

## Request body

- BroadcastRequest: Body for ``POST /broadcast``. Typing the body with a model lets FastAPI reject non-object or malformed JSON with a ``422`` instead of letting ``dict.get`` (or a ``JSONDecodeError``) raise an unhandled exception. ``message`` defaults to an empty string so a missing field still funnels into the existing ``400 message is required`` path.
  - `message` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bernstein/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/bernstein/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc.dev/bernstein/apis/bernstein-task-server/revisions/2a20a34ad2eb?raw)